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About  this  guide 


This  reference  guide  provides  information  to  help  you: 

•  Understand  and  use  Fabric  Operating  System  (Fabric  OS)  commands 

•  Manage  a  switch  or  fabric 

[sf  NOTE:    FICON  is  not  supported  on  HP  B-Series  Fibre  Channel  switches.  The  FICON  information  in  this 
document  is  included  for  reference  only. 


Intended  audience 

This  guide  is  intended  for: 

•  System  administrators  responsible  for  HP  StorageWorks  Fibre  Channel  Storage  Area  Network  (SAN) 
switches 

•  Technicians  responsible  for  maintaining  the  Fabric  Operating  System  (OS) 

Related  documentation 

Documentation,  including  white  papers  and  best  practices  documents,  is  available  on  the  HP  web  site: 

http:/ / www.hp.com/ country/ us/ eng/ prodserv/ storage.html 

&f  IMPORTANT:    For  late  breaking,  supplemental  information,  access  the  latest  version  of  the  HP 

StorageWorks  Fabric  OS  5.x  release  notes  using  the  following  steps. 


To  access  current  Fabric  OS  5.x  related  documents: 

1 .  Locate  the  IT  storage  products  section  of  the  web  page. 

2.  Under  Networked  storage,  click  SAN  infrastructure. 

3.  From  the  SAN  Infrastructure  web  page,  locate  the  SAN  Infrastucture  products  section. 

4.  Click  Fibre  Channel  Switches. 

5.  Locate  the  B-Series  Fabric-Enterprise  Class  section.  Click  4/256  SAN  Director  and  4/256  SAN 
Director  power  pack,  to  access  Fabric  OS  5.x  documents  (such  as  this  document). 

The  switch  overview  page  displays. 

6.  Go  to  the  Product  Information  section,  located  on  the  right  side  of  the  web  page. 

7.  Click  Technical  documents. 

8.  Follow  the  onscreen  instructions  to  download  the  applicable  documents. 

HP  StorageWorks  Fabric  OS  5.x  master  glossary 

This  guide  uses  industry  standard  SAN  terminology.  However,  some  terms  are  intrinsic  to  Fabric  OS  5.x. 
Refer  to  the  HP  StorageWorks  Fabric  OS  5.x  master  glossary  for  a  complete  list  of  terms  and  definitions. 

Access  the  master  glossary  from  the  HP  StorageWorks  SAN  Switch  Documentation  CD  that  shipped  with 
your  switch.  Also,  access  from  the  HP  web  site  using  the  procedure  outlined  in  "Related  documentation". 
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Document  conventions  and  symbols 


Table  1    Document  conventions 


Convention 

Element 

Medium  blue  text:  Figure  1 

Cross-reference  links  and  e-mail  addresses 

Medium  blue,  underlined  text 

(httrv/ /www  hn  com  1 

\  I  ] ||     .  /  /  vv  vy  vy .  1 1  p .\.ui  1 1  j 

Web  site  addresses 

Bold  font 

•  Kp\/  nnnp1; 

i\cy   II \A  1 1 1 c o 

•  Text  typed  into  a  GUI  element,  such  as  into  a  box 

•  GUI  elements  that  are  clicked  or  selected,  such  as  menu  and  list 
items,  buttons,  and  check  boxes 

Italics  font 

Text  emphasis 

Monospace  font 

•  File  and  directory  names 

•  System  output 

•  Code 

•  Tpyt  tvnpn  nt  thp  rnmmnnn-  inp 

1  CAI    IV  UtU    \Jl  1    NIC   >  1  1  1  1  1  IU  1  1  u  1  1  1  1  \* 

Monospace,   italic  font 

•  Code  variables 

•  Command-line  variables 

Monospace,  bold  font 

Emphasis  of  file  and  directory  names,  system  output,  code,  and  text 
typed  at  the  command  line 

A  WARNING!    Indicates  that  failure  to  follow  directions  could  result  in  bodily  harm  or  death. 


A  CAUTION:    Indicates  that  failure  to  follow  directions  could  result  in  damage  to  equipment  or  data. 


&f  IMPORTANT:    Provides  clarifying  information  or  specific  instructions. 


NOTE:    Provides  additional  information. 


&  TIP:    Provides  helpful  hints  and  shortcuts. 
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HP  technical  support 

Telephone  numbers  for  worldwide  technical  support  are  listed  on  the  HP  support  web  site: 

http:/ / www.hp.com/ support/. 

Collect  the  following  information  before  calling: 

•  Technical  support  registration  number  (if  applicable) 

•  Product  serial  numbers 

•  Product  model  names  and  numbers 

•  Applicable  error  messages 

•  Operating  system  type  and  revision  level 

•  Detailed,  specific  questions 

For  continuous  quality  improvement,  calls  may  be  recorded  or  monitored. 

HP  strongly  recommends  that  customers  sign  up  online  using  the  Subscriber's  choice  web  site: 

http://www.hp.com/ go/ e-updates. 

•  Subscribing  to  this  service  provides  you  with  e-mail  updates  on  the  latest  product  enhancements, 
newest  versions  of  drivers,  and  firmware  documentation  updates  as  well  as  instant  access  to  numerous 
other  product  resources. 

•  After  signing  up,  you  can  quickly  locate  your  products  by  selecting  Business  support  and  then  Storage 
under  Product  Category. 

HP-authorized  reseller 

For  the  name  of  your  nearest  HP-authorized  reseller: 

•  In  the  United  States,  call  1-800-282-6672. 

•  Elsewhere,  visit  the  HP  web  site:  http://www.hp.com.  Then  click  Contact  HP  to  find  locations  and 
telephone  numbers. 

Helpful  web  sites 

For  other  product  information,  see  the  following  HP  web  sites: 

•  http://www.hp.com 

•  http:/  /  www.hp.com/ go/ storage 

•  http://www.hp.com/support/ 

•  http://www.docs.hp.com 
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Fabric  OS  command  line  interface 


This  chapter  explains  the  different  methods  used  to  manage  HP  SAN  and  HP  StorageWorks  switches.  The 
following  information  is  discussed: 

•  Understanding  access  levels,  page  17 

•  Using  the  Fabric  OS  command  line  interface,  page  1 8 

•  Using  this  guide,  page  19 


Understanding  access  levels 

Fabric  OS  supports  two  classes  of  user  accounts:  default  and  multiple  user  account  (MUA). 
Default  accounts,  introduced  in  early  versions  of  Fabric  OS,  include  root,  factory,  admin,  and  user. 

•  The  root  and  factory  levels  are  reserved  for  support  and  manufacturing  personnel. 

•  The  admin  accounts  are  intended  for  general  switch  and  fabric  administration  activities.  The  admin 
role  can  perform  all  Fabric  OS  operations. 

•  The  user  accounts  are  intended  for  general  switch  and  fabric  administration  activities.  The  user  role 
performs  observation-only  operations. 

•  Each  account  has  hard-coded  permissions  that  define  roles  whose  privileges  correspond  to  the 
account  name. 

In  HP's  Fabric  OS  3.x  and  earlier,  multiple-user  access  to  a  switch  is  limited.  Each  switch  enables  only  a 
single  session  per  access  method,  regardless  of  the  user's  access  level.  Switches  can,  however,  be 
accessed  simultaneously  from  different  connections;  for  example,  through  the  command  line  interface 
(CLI)  and  HP  Web  Tools.  If  this  happens,  changes  from  one  connection  might  not  be  updated  to  the  other, 
and  some  changes  might  be  lost.  When  you  connect  using  simultaneous  multiple  connections,  ensure  that 
you  do  not  overwrite  the  work  of  another  connection. 

In  Fabric  OS  v5.x,  multiple  sessions  are  allowed.  Each  access  level  can  have  the  number  of  simultaneous 
logins  shown  in  Table  2. 

Table  2    Fabric  OS  v5.x  user  access  maximum  sessions 


User  name 

Maximum  number  of  simultaneous  sessions 

admin 

2 

user 

4 

The  MUA  feature  distinguishes  between  a  user  account  and  the  role  assigned  to  the  account.  The 
switchAdmin  role,  introduced  in  Fabric  OS  v5.x,  has  most  of  the  existing  administrative  permissions, 
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except  the  ability  to  perform  zone  and  security  configuration  and  user  management.  See  Table  3  for  a 
high-level  description  of  role  permissions. 

Table  3    Role  permissions 


Functional  Area 

user 

switchAdmin 

admin 

Zone  configuration 

View 

View 

Modify 

Environmental 

View 

Modify 

Modify 

Logs  (RAS) 

View 

Modify 

Modify 

Security 

View 

View 

Modify 

Switch  configuration 

View 

Modify 

Modify 

Switch  management 

View 

Modify 

Modify 

Port  configuration 

View 

Modify 

Modify 

SNMP 

View 

Modify 

Modify 

Diagnostics 

View 

Modify 

Modify 

Devices 

View 

Modify 

Modify 

User  management 

View 

N.A. 

Modify 

Fabric  Watch 

View 

Modify 

Modify 

Advanced  Performance  Monitor 

View 

Modify 

Modify 

Admin  domain  management 

View 

N.A. 

Modify 

The  MUA  feature  was  introduced  in  Fabric  OS  v3.2.0/v4.4.0  and  the  switchAdmin  can  log  in;  however, 
the  role  is  restricted  to  user-level,  observation-based  functions. 

This  manual  lists  all  the  commands  available  to  the  user-  and  admin-level  logins.  See  "MUA-based  roles" 
on  page  777  for  commands  available  to  the  switchAdmin  role. 


[?5£}f  NOTE:   The  admin  access  level  has  access  to  all  the  commands  needed  to  manage  and  configure  a 
switch  or  fabric.  The  admin  account  is  the  recommended  login  level. 


Using  the  Fabric  OS  command  line  interface 

The  Fabric  OS  command  line  interface  (CLI),  accessed  through  either  telnet  or  serial  console,  provides  an 
administrator  with  full  management  capability  on  an  HP  StorageWorks  switch.  The  Fabric  OS  CLI 
enables  an  administrator  to  monitor  and  manage  entire  fabrics,  individual  switches,  and  ports  from  a 
standard  workstation.  The  entire  suite  of  Fabric  OS  features  and  capabilities  is  available  across  an  entire 
fabric,  from  a  single  access  point.  Selected  commands  must  be  issued  from  a  sectelnet  or  SSH  session,  as 
indicated  in  the  command  description  in  this  manual. 

Access  is  controlled  by  a  switch-level  password  for  each  access  level.  The  commands  available  through 
the  CLI  are  based  on  the  user's  login  level  and  the  license  keys  used  to  unlock  certain  features. 

Fabric  OS  CLI  is  the  complete  fabric  management  tool  for  HP  SANs  and  provides  the  following: 
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•  Access  to  the  full  range  of  Fabric  OS  features,  based  on  which  license  keys  you  purchase 

•  Assistance  with  configuration,  monitoring,  dynamic  provisioning,  and  daily  management  of  every 
aspect  of  storage  area  networks 

•  A  deeper  view  of  the  tasks  involved  in  managing  a  StorageWorks  switch  or  director 

•  Configuration  and  management  of  the  HP  fabric  on  multiple  levels 

•  Identification,  isolation,  and  management  of  SAN  events  across  every  switch  in  the  fabric 

•  Management  switch  licenses 

Using  this  guide 

This  guide  describes  each  command,  including  a  synopsis  of  its  syntax  and  the  users  to  which  it  is 
available,  and  provides  a  description  of  command  usage  and  behavior.  The  same  information  is 
available  to  you  on  your  HP  StorageWorks  SAN  Switch  or  Director,  using  the  help  command.  For 
example,  to  display  the  help  or  man  page  for  aliAdd,  type: 

switch : admin>  help  aliadd 


Fabric  OS  5.x  command  reference  guide     1 9 


Fabric  OS  command  line  interface 


2    Fabric  OS  commands 


This  chapter  lists  the  Fabric  OS  commands.  It  also  shows  their  syntax  and  operands,  and  provides 
examples  of  their  usage. 
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aaaConfig 

Manages  RADIUS  configuration  information. 


Synopsis 

aaaconfig   [action]  [options] 

Availability 

admin 

Description 

Use  this  command  to  manage  the  RADIUS  configuration  for  the  authentication,  authorization,  and 
accounting  (AAA)  services.  This  command  displays,  adds,  removes,  changes,  enables,  or  disables 
RADIUS  configuration. 

When  the  command  completes,  any  new  configuration  is  saved  persistently.  It  is  effective  for  the  next 
AAA  request.  The  configuration  applies  to  all  switch  instances  in  a  platform  supporting  multiple  switch 
domains. 

Use  the  centralized  RADIUS  servers  to  manage  AAA  services  for  a  switch,  as  defined  in  RFC  2865. 


r2^f  NOTE:   This  command  can  be  executed  when  you  are  logged  in  through  the  console,  or  a  serial  or  SSH 
connection. 


Operands 


The  command  takes  as  input  an  action  and  its  associated  options.  Without  any  specified  action,  the 
command  displays  the  usage.  Specify  action  as  one  of  following: 


--show 

--add  server  [options] 
--remove  server 
--change  server  [options] 
--move  server  to_position 


--radius    [on   |  off] 
--switchdb   [on   I  off] 


Displays  the  current  AAA  service  configuration. 

Adds  a  RADIUS  server  to  the  configuration. 

Removes  a  RADIUS  server  from  the  configuration. 

Changes  a  RADIUS  server  configuration. 

Moves  a  RADIUS  server  from  the  current  position  to  a  new 
position.  When  server  is  a  required  operand  for  an  action,  it 
must  be  either  an  IP  address  or  a  name  in  dot  notation.  If  a 
name  is  used,  DNS  must  be  properly  configured. 

Turns  on  or  off  the  current  RADIUS  configuration. 

Turns  on  or  off  the  switch  local  database  as  secondary 
authentication. 


The  following  are  the  options  for  the  --add  and  --change  actions: 


-p  port 

-s  secret 

-t  timeout 

-a   [pap   |  chap] 


RADIUS  server  port  number 

Common  secret  between  the  switch  and  RADIUS  server 
Response  timeout  for  the  RADIUS  server 
Use  PAP  or  CHAP  as  authentication  protocol 
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The  following  provides  a  detailed  description  of  each  action  type: 

--show  List  the  current  RADIUS  servers,  along  with  their  parameters. 
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-add  server  [-p  port]    [-s  secret]    [-t  timeout]    [-a  chap   |  pap] 

Add  the  specified  server  to  the  end  of  the  RADIUS 
configuration  list,  with  the  specified  port  number,  shared 
secret,  timeout,  and  if  PAP  or  CHAP  is  to  be  used  as 
authentication  protocol,  server  must  be  different  from  the 
servers  in  the  existing  configuration. 

-remove  server  Remove  the  specified  server  from  the  RADIUS  configuration 

list.server  must  match  a  server  in  the  existing  configuration. 
To  remove  the  last  server,  you  must  disable  the  RADIUS 
configuration  first. 

--change  server  [-p  port]    [-s  secret]    [-t  timeout]    [-a  chap   |  pap] 

Change  parameters  for  the  specified  server  in  the  existing 
RADIUS  configuration  list,  server  must  match  one  in  the 
existing  configuration. 

--move  server  to_position         Move  the  specified  server  in  the  existing  RADIUS  configuration 

list  from  the  current  position  to  the  specified  new  position.  This 
rearranges  the  order  in  which  the  specified  RADIUS  server  is 
used. 

Enable  or  disable  the  current  RADIUS  configuration  for  AAA 
services.  This  is  used  to  switch  the  primary  AAA  services 
between  RADIUS  and  the  switch  local  database.  To  enable  the 
RADIUS  configuration,  there  must  be  at  least  one  server 
existing  in  the  configuration. 

Enable  or  disable  the  switch  local  database  as  the  secondary 
AAA  services.  When  enabled,  if  RADIUS  requests  a  timeout  for 
all  RADIUS  servers,  the  switch  local  database  is  used  for 
authentication;  otherwise,  requests  are  denied. 


--radius    [on   I  off] 


-switchdb   [on   I  off! 


mples 


To  display  the  current  RADIUS  configuration: 


switch : admin>  aaaconfig  --show 

Position  Server 

Port 

Secret    Timeout (s) 

Auth- Protocol 

1  192.168.233.48 

1812 

sharedsecret  3 

CHAP 

2  192.168.233.44 

1812 

sharedsecret  3 

CHAP 

3  radserver 

1812 

private  5 

CHAP 

Primary  AAA  Service: 

Switch 

database 

Secondary  AAA  Service :  None 

To  change  the  configuration  for  server  192.168.233.48: 


switch : admin>  aaaconfig  --change  192.168.233.48  -p  3002  -s  newsecret  -t  1 


also 


none 
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agtCfg  Default 

Resets  the  SNMP  agent  configuration  to  default  values. 

Synopsis 

agtcf gde fault 

Availability 

admin 


Description 

Use  this  command  to  reset  the  SNMP  agent  configuration  with  the  switch  default  values. 

This  command  prompts  the  user  and  proceeds  to  reset  only  on  the  user's  confirmation.  All  new  values 
successfully  configured  by  the  command  take  effect  immediately.  These  changes  are  persistent  across 
power  cycles  and  reboots.  For  dual-domain  systems,  agtCfgDef ault  operates  on  the  SNMP  agent 
associated  with  the  current  switch. 

This  command  resets  the  following  values  (See  the  HP  StorageWorks  Fabric  OS  5.x  MIB  reference  guide 
for  detailed  sysDescr,  sysLocation,  and  sysContact  descriptions): 

sysDescr  The  system  (switch)  description.  The  default  value  is  Fibre  Channel  Switch  in  most 

platforms;  however,  the  default  system  description  value  is  platform-specific. 
Different  values  might  appear  as  the  default  for  some  specialized  platforms. 

sysLocation        The  location  of  the  system.  The  default  value  is  End  User  Premise. 

sysContact  The  contact  information  for  the  system.  The  default  value  is  Field  Support. 

authTraps  When  enabled,  the  authentication  trap,  authenticationFailure,  is  transmitted  to  a 

configured  trap  recipient  in  the  event  the  agent  received  a  protocol  message  that 
is  not  properly  authenticated.  In  the  context  of  SNMPvl  and  SNMPv2c,  this 
means  that  a  request  contains  a  community  string  that  is  not  known  to  the  agent. 
The  default  value  for  this  parameter  is  0  (disabled). 

There  are  six  communities  and  respective  trap  recipients  supported  by  the  agent.  The  first  three 
communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The  default 
value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  default  values  for  the  community  strings  are 
as  follows: 

Community  1 :  Secret  Code 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 

Trap  recipient  severity  level 

The  trap  severity  level  is  associated  with  each  trap  recipient  IP  address.  The  event  trap  level  is  in 
conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity  level  is  at  or  below  the 
set  value,  the  SNMP  event  traps  (swEventTrap,  swFabricWatchTrap,  and  connUnitEventTrap) 


Fabric  OS  5.x  command  reference  guide  25 


are  sent  to  the  trap  recipients.  By  default,  this  value  is  set  to  0,  implying  that  no  such  traps  are  sent. 
Possible  values  are  as  follows: 


0 

none 

1 

critical 

2 

error 

3 

warning 

4 

informationa 

5 

debug 

See  errModuleShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
1 92. 1 68.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of 
six  entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


r2£^  NOTE:   When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
b— I    and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  FCS  switch  only  and 
will  propagate  changes  across  the  fabric. 


Operands 

none 

Examples 

To  reset  the  SNMP  agent  to  default  values: 

switch : admin>  agtcf gdef ault 

*  *  k  ic  k 

This  command  will  reset  the  agent's  configuration  back  to  factory- 
default 

k  ic  k  ic  k 

Current  SNMP  Agent  Configuration 
Customizable  MIB-II  system  variables: 

sysDescr  =  Fibre  Channel  Switch. 
sysLocation  =  End  User  Premise 
sysContact  =  sweng 
authTraps  =  0  (OFF) 

(continued  on  next  page) 
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SNMPvl  community  and  trap  recipient  configuration: 

Community  1:   Secret  COde  (rw) 
Trap  recipient:  192.168.15.41 
Trap  recipient  Severity  level :  4 

Community  2:   OrigEquipMfr  (rw) 

No  trap  recipient  configured  yet 


Community  3 :  private  (rw) 

No  trap  recipient  configured  yet 

Community  4:  public  (ro) 

No  trap  recipient  configured  yet 

Community  5:   common  (ro) 

No  trap  recipient  configured  yet 

Community  6:   FibreChannel  (ro) 

No  trap  recipient  configured  yet 


SNMP  access  list  configuration: 


Entry  0 
Entry  1 
Entry  2 
Entry  3 
Entry  4 
Entry  5 


Access  host  subnet  area  192.168.64.0    (rw) ] 

No  access  host  configured  yet 

No  access  host  configured  yet 

No  access  host  configured  yet 

No  access  host  configured  yet 

No  access  host  configured  yet 


Are  you  sure?    (yes,   y,   no,   n) :    [no]  y 
Committing  configuration ...  done . 
agent  configuration  reset  to  factory  default 
Current  SNMP  Agent  Configuration 
Customizable  MIB-II  system  variables: 

sysDescr  =  Fibre  Channel  Switch. 
sysLocation  =  End  User  Premise 
sysContact  =  Field  Support. 
authTraps  =  0  (OFF) 


(continued  on  next  page) 
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LJ1LLL  L  L  Li  1 1  _L  U_y 

and  trap  recipient  configuration: 

f"1  l~lTYlTYn  1T1  1    f"  \  7 

\^  UllULLLLil  -L  U_y 

1:   Secret  COde  (rw) 

IN  U     UI  CL^J 

recipient  configured 

yet 

t  1  fimini  im  (-17 
*„UIIU[LUI1  J. 

2:   OrigEquipMfr  (rw) 

IN  (J     U-L  cLLJ 

recipient  configured 

yet 

f"1  l~lTYlTYn  1T1  1    f"  \  7 

UllULLLill -L  U_y 

3 :  private   ( rw) 

l\Tn  tr^D 

J-*J  ' — '       1  1_  Ci_^-' 

recipient  configured 

yet 

4:   public  (ro) 

1NO     U-L  CLLJ 

recipient  configured 

yet 

1   1  i~iTYlTYn  1  TO  "1    t~  T  T 

*„UIIU[LI_II1-L  Ly 

5:   common  (ro) 

No  trap 

recipient  configured 

yet 

Community 

6:   FibreChannel  (ro) 

No  trap 

recipient  configured 

yet 

SNMP  access  list 

configuration : 

Entry 

0:     No  access  host  configured  yet 

Entry 

1:     No  access  host  configured  yet 

Entry 

2:     No  access  host  configured  yet 

Entry 

3:     No  access  host  configured  yet 

Entry 

4:     No  access  host  configured  yet 

Entry 

5:     No  access  host  configured  yet 

See  also 

agtCfgSet 
agtCf gShow 
snmpConf ig 
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agtCfgSet 

Modifies  the  SNMP  agent  configuration. 

Synopsis 

agtcf gset 

Availability 

admin 

Description 

Use  this  command  to  modify  the  configuration  of  the  SNMP  agent  in  the  switch. 

All  values  successfully  configured  by  this  command  take  effect  immediately.  These  values  are  persistent 
across  power  cycles  and  reboots.  For  dual-domain  systems,  this  command  operates  on  the  SNMP  agent 
associated  with  the  current  switch. 

This  command  updates  the  following  values  (See  the  HP  StorageWorks  Fabric  OS  5.x  MB  reference 
guide  for  detailed  sysDescr,  sysLocation,  and  sysContact  descriptions): 

sysDescr  The  system  (switch)  description.  The  default  value  is  Fibre  Channel 

Switch  in  most  platforms;  however,  the  default  system  description 
value  is  platform  specific.  Different  values  might  appear  as  the 
default  for  some  specialized  platforms. 

sysLocation  The  location  of  the  system.  The  default  value  is  End  User  Premise. 

sysContact  The  contact  information  for  the  system.  The  default  value  is  Field 

Support. 

authTrapsEnabled  When  enabled,  the  authentication  trap,  authenticationFailure,  is 

transmitted  to  a  configured  trap  recipient  in  the  event  the  agent 
received  a  protocol  message  that  is  not  properly  authenticated.  In 
the  context  of  SNMPvl  and  SNMPv2c,  this  means  that  a  request 
contains  a  community  string  that  is  not  known  to  the  agent.  The 
default  value  for  this  parameter  is  0  (disabled). 

There  are  six  communities  and  respective  trap  recipients  supported  by  the  agent.  The  first  three 
communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The  default 
value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  default  values  for  the  community  strings  are 
as  follows: 

Community  1 :  Secret  Code 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 
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Trap  recipient  severity  level 

The  trap  severity  level  is  associated  with  each  trap  recipient  IP  address.  The  event  trap  level  is  in 
conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity  level  is  at  or  below  the 
set  value,  the  SNMP  event  traps  (swEventTrap,  swFabricWatchTrap,  and  connUnitEventTrap) 
are  sent  to  the  trap  recipients.  By  default,  this  value  is  set  to  0,  implying  that  no  such  traps  are  sent. 
Possible  values  are  as  follows: 


0 


none 


critical 


2 


error 


3 
4 


warning 

informational 

debug 


5 


See  errModuleShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
1 92. 1 68.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of 
six  entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


r2^>  NOTE:   When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
LJ    and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  FCS  switch  only  and 
will  propagate  changes  across  the  fabric. 


Operands 

none 

Examples 

To  modify  the  SNMP  configuration  values: 


switch : admin>  agtcfgset 


Customizing  MIB-II  system  variables 


At  each  prompt,   do  one  of  the  followings: 


o  <Return>  to  accept  current  value 


o  enter  the  appropriate  new  value, 


o  <Control-D>  to  skip  the  rest  of  configuration,  or 


o  <Control-C>  to  cancel  any  change. 


(continued  on  next  page) 
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To  correct  any  input  mistake: 

<Backspace>  erases  the  previous  character, 
<Control-U>  erases  the  whole  line, 
sysDescr:    [FC  Switch] 
sysLocation:    [End  User  Premise] 
sysContact:    [Field  Support.] 

authTrapsEnabled   (true,    t,    false,    f ) :  [true] 
SNMP  community  and  trap  recipient  configuration: 
Community   (rw) :    [Secret  COde] 

Trap  Recipient's  IP  address  in  dot  notation:  [192.168.1.51] 
Trap  recipient  Severity  level   :    (0..5)    [0]  3 
Community   (rw) :    [OrigEquipMf r ] 

Trap  Recipient's  IP  address  in  dot  notation:  [192.168.1.26] 
Trap  recipient  Severity  level   :    (0..5)  [0] 
Community   (rw) :  [private] 

Trap  Recipient's  IP  address  in  dot  notation:    [0.0.0.0]  192.168.64. 
Trap  recipient  Severity  level   :    (0..5)    [0]  1 
Community   (ro) :  [public] 

Trap  Recipient's  IP  address  in  dot  notation:  [0.0.0.0] 
Community   (ro) :  [common] 

Trap  Recipient's  IP  address  in  dot  notation:  [0.0.0.0] 
Community   (ro) :    [FibreChannel ] 


Trap  Recipient's  IP  address  in 

dot  notation; 

[0. 

.0. 

SNMP  access  list 

configuration : 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

,0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

,0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

,0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Access  host 

subnet 

area  in  dot 

notation : 

[0. 

.  0 

.0. 

.0] 

Read/Write? 

(true, 

t,   false,  f) 

:  [true] 

Committing  configuration ...  done . 
value  =  1  =  0x1 


See  also 

agtCf gDef ault 
agtCf gShow 
snmpConf ig 

SW_v5_x.mib,  Switch  Management  Information  &  Switch  Enterprise  Specific  Trap 
RFC1  157,  A  Simple  Network  Management  Protocol  (SNMPvl) 

RFC1 21 3,  Management  information  Base  for  Network  Management  of  TCP/IP-based  internets:  MIB-II 
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agtCfgShow 

Displays  the  SNMP  agent  configuration. 

Synopsis 

agtcf gshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  configuration  of  the  SNMP  agent  in  the  switch. 

("2^f  NOTE:    On  a  dual-switch  chassis,  there  is  one  SNMP  agent  per  logical  switch.  This  command  is  specific 
to  the  logical  switch  you  are  logged  in  to. 


The  following  information  displays: 

sysDescr  The  system  (switch)  description.  The  default  value  is  Fibre  Channel  Switch. 

sysLocation  The  location  of  the  system.  The  default  value  is  End  User  Premise. 

sysContact  The  contact  information  for  the  system.  The  default  value  is  Field  Support. 

See  the  HP  StorageWorks  Fabric  OS  5.x  MIB  reference  guide  for  detailed 

sysDescr,  sysLocation,  and  sysContact  descriptions. 

authTrapsEnabled      When  enabled,  the  authentication  trap,  authenticationFailure,  is 

transmitted  to  a  configured  trap  recipient  in  the  event  that  the  agent  received 
a  protocol  message  that  is  not  properly  authenticated.  In  the  context  of 
SNMPvl  and  SNMPv2c,  this  means  that  a  request  contains  a  community 
string  that  is  not  known  to  the  agent.  The  default  value  for  this  parameter  is 
0  (disabled). 

There  are  six  communities,  respective  trap  recipients,  and  trap  recipients  supported  by  the  agent.  The  first 
three  communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro)  access.  The 
default  value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  community  string  length  ranges 
from  2  to  1 6  characters.  The  default  values  for  the  community  strings  are: 

•  Community  1:  Secret  COde 

•  Community  2:  OrigEquipMfr 

•  Community  3:  private 

•  Community  4:  public 

•  Community  5:  common 

•  Community  6:  FibreChannel 

For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  access  control  list  (ACL)  check. 
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Trap  recipient  severity  level 

The  event  trap  level  in  conjunction  with  the  event's  severity  level.  When  an  event  occurs  and  if  its  severity 
level  is  at  or  below  the  set  value,  the  SNMP  trap,  swEventTrap,  is  sent  to  configured  trap  recipients.  By 
default,  this  value  is  set  to  0,  implying  that  no  swEventTrap  is  sent.  Possible  values  are: 


0 

none 

1 

critical 

2 

error 

3 

warning 

4 

informationa 

5 

debug 

See  errShow  for  related  information. 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
192.168.64.0  enables  access  by  any  hosts  that  start  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of 
six  entries  is  given  to  the  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0. 


r™^>  NOTE:   When  secure  mode  is  enabled,  the  access  control  list  feature  is  incorporated  into  the  WSNMP 
LJ    and  RSNMP  security  policies.  Community  strings  can  be  changed  on  the  primary  FCS  switch  only  and 
will  propagate  changes  across  the  fabric. 


Operands 

none 

Examples 


switch : admin>  agtcfgshow 

Current  SNMP  Agent  Configuration 

Customizable  MIB-II  system  variables: 

sysDescr  =  FC  Switch 

sysLocation  =  End  User  Premise 

sysContact  =  Field  Support. 

authTraps  =  1  (ON) 

SNMPvl  community  and  trap  recipient  configuration: 

Community  1:   Secret  COde  (rw) 

Trap  recipient:  192.168.1.51 

Trap  recipient  Severity  level 

:  4 

Community  2:   OrigEquipMfr  (rw) 

Trap  recipient:  192.168.1.26 

Trap  recipient  Severity  level 

:  0 

Community  3:  private  (rw) 

No  trap  recipient  configured 

yet 

(continued  on  next  page) 
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Community  4:  public  (ro) 

No  trap  recipient  configured  yet 
Community  5:   common  (ro) 

No  trap  recipient  configured  yet 
Community  6:   FibreChannel  (ro) 

No  trap  recipient  configured  yet 


SNMP  access  list  configuration: 

Entry  0:     Access  host  subnet  area  192.168.64.0    (rw)  ] 

Entry  1:     No  access  host  configured  yet 

Entry  2 :     No  access  host  configured  yet 

Entry  3 :     No  access  host  configured  yet 

Entry  4 :     No  access  host  configured  yet 

Entry  5:     No  access  host  configured  yet 

See  also 

agtCfgDefault 
agtCfgSet 
snmpConf ig 
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aliAdd 


Adds  a  member  to  a  zone  alias. 

Synopsis 

aliadd  " aliName",  "member;  member" 

Availability 

admin 


[?2hf  NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone  alias.  The  alias  member  list  cannot 
contain  another  zone  alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


This  command  has  the  following  required  operands: 


"aliName" 
"member" 


Specify  the  name  of  a  zone  alias,  in  quotation  marks. 

Specify  a  member  or  list  of  members  to  be  added  to  the  alias,  in 
quotation  marks,  separated  by  semicolons.  An  alias  member 
can  be  specified  by  one  or  more  of  the  following  methods: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

•  WWN 

•  QuickLoop  AL_PAs 


Examples 


To  add  members  to  zone  aliases  array! ,  array 2,  and  loop! : 


switch 

admin> 

aliadd 

" arrayl " 

"1,2" 

switch 

admin> 

aliadd 

" array2 " 

"21:00:00 

20  : 

37:0c:72:51" 

switch 

admin> 

aliadd 

" loopl " , 

"4, 5 [0x02] 

6, 

7 [OxEF] " 
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aliCreate 
aliDelete 
aliRemove 
aliShow 


Fabric  OS  command 


aliasDelete 

Deletes  a  port  from  all  local  groups. 

Synopsis 

aliasDelete  portID 

Availability 

admin 

Description 

Use  this  command  to  delete  a  local  port  from  all  local  groups.  The  group  is  deleted  if  it  becomes  empty 
after  deleting  the  local  port. 

Use  the  aliasShow  command  to  show  the  existing  groups  with  its  corresponding  N_Ports. 

Operands 

The  following  aliasDelete  argument  is  required. 
portID  The  port  ID  in  its  hexadecimal  representation 

Examples 

To  delete  a  port  from  an  existing  group: 

switch : admin>  aliasdelete  0xl9c00 
aliasDelete:  succeeded 


Exit  status 


0  Successful  operation 

nonzero  Indicates  the  operation  has  failed 


See  also 

alias Join 
aliasShow 
f abricShow 
switchShow 
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aliasJoin 

Creates  a  multicast  alias  group  of  NPorts.  If  the  group  already  exists,  the  NPorts  are  added  to  the 
existing  group. 

Synopsis 

aliasJoin 

Availability 

admin 

Description 

Use  this  command  to  create  a  multicast  alias  group  of  N  Ports  or  to  add  N  Ports  to  an  existent  group. 
Any  online  N_Port  defined  in  the  fabric  can  be  part  of  a  group.  An  N_Port  can  be  added  from  any  switch 
that  is  part  of  the  fabric. 

To  get  a  list  of  online  ports  currently  defined  in  the  fabric,  use  the  nsAllShow  command.  If  the  user 
wants  to  add  only  local  ports  associated  with  the  local  switch,  use  the  nsShow  command  to  get  list  of 
ports  associated  with  the  local  switch. 

Operands 

none 

Examples 


To  create  an  alias  group  of  N  Ports  or  to  add  N  Ports  to  an  existing  group: 

switch : admin>  aliasJoin 

aliasJoin:   To  add  ports  to  an  existing  or  new  multicast 

group 

Number  of  ports  in  the  group:    (1..64)  [1] 

To  set  an  authorization  password?    (yes,  y,   no,   n) :  [no] 

no  password 

Setting  the  authorization  control 

Add  control:   0  by  any,    1  only  itself,    2  by  creator:    (0. . 

2) 

[0] 

Del  control:   0  by  any,    1  only  itself,    2  by  creator:    (0. . 

2) 

[0] 

Lsn  control:   0  by  any,    1  by  none:    (0..1)  [1] 

Add  control  0,   Del  control  0  Lsn  control  1 

Setting  the  Routing  Bit:    (Ox0..0xc)  [0x0] 

using  FC-4  Device  Data   . . . 

Setting  FC-4  Type:    (0x0..0x5d)  [0x5] 

using  0x05   . . . 

To  set  the  alias  qualifier  in  WVfN  format?     (yes,  y,  no, 

n) 

[yes] 

Qualifier    (in  hex):  [10:00:00:60:69:80:02:28] 

Port  ID   (in  hex) :    ( 0x0 . . Oxef f aOO )    [0]  0xl9c00 

npList[0]   =  0xl9c00 

aliasJoin:  Join  request  to  Group  Address  OxfffbOO  succeeds 
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Exit  status 

0  Successful  operation 

nonzero  Indicates  the  operation  has  failed 

See  also 

aliasDelete 

aliasPurge 

aliasShow 

f abricShow 

nsAHShow 

nsShow 
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aliasPurge 

Removes  an  alias  group. 

Synopsis 

aliasPurge  groupID 

Availability 

admin 

Description 

Use  this  command  to  remove  an  alias  group. 

Operands 

The  following  aliasPurge  argument  is  required. 
groupID  It  is  the  group  ID  in  its  hexadecimal  representation 

Examples 

To  remove  an  alias  group: 

switch : admin>  aliasPurge  OxfffbOO 
aliasPurge:  succeeded 


Exit  status 


0  Successful  operation 

nonzero  Indicates  the  operation  has  failed 


See  also 

alias Join 
aliasShow 
f abricShow 
switchShow 
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aliasShow 

Displays  local  alias  server  information. 

Synopsis 

aliasShow 

Availability 

all  users 

Description 

Use  this  command  to  display  local  information.  If  there  is  no  local  alias  group,  a  message  is  displayed.  If 
there  are  multiple  entries  in  the  local  alias  group,  they  are  displayed. 

Operands 

none 

Examples 

To  display  the  entries  in  the  local  alias  server: 

switch : admin>  aliasShow 

{AliasID  Creator  Token   [rb,    type,   grptype,   qlfr]   Member  List 
fffbOO     fffffd   [00,    05,    10,    10000060  69800228]    {   019c00  } 

} 

The  Local  Alias  Server  has  1  entry 


Exit  status 


0  Successful  operation 

nonzero  Indicates  the  operation  has  failed 


See  also 

f abricShow 
switchShow 
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aliCreate 


Creates  a  zone  alias. 


Synopsis 


alicreate  "aliName",   "member;  member" 


Availability 

admin 


NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  create  a  new  zone  alias.  The  zone  alias  member  list  must  have  at  least  one  member 
(empty  lists  are  not  allowed).  The  alias  member  list  cannot  contain  another  zone  alias.  See  the 
zoneCreate  command  for  more  information  on  name  and  member  specifications. 

Zone  alias  members  can  be  specified  using  the  area  number  to  represent  a  specific  port  and  slot 
combination.  Area  numbers  are  automatically  assigned  to  a  port  by  the  Fabric  OS.  You  can  view  the 
Area  numbers  using  the  switchShow  command. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


This  command  has  the  following  operands: 


"aliName" 


member 


Specify  a  name  for  the  zone  alias,  in  quotation  marks.  This 
operand  is  required.  A  zone  alias  name  must  begin  with  a  letter 
and  can  be  followed  by  any  number  of  letters,  digits  and 
underscore  characters.  Names  are  case  sensitive:  for  example, 
"Ali_l"  and  "ali_l"  are  different  zone  aliases.  Spaces  are 
ignored. 

Specify  a  member  or  list  of  members  to  be  added  to  the  alias,  in 
quotation  marks,  separated  by  semicolons.  An  alias  member 
can  be  specified  by  one  or  more  of  the  following  methods: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

.  WWN 

•  QuickLoop  AL_PAs 
This  operand  is  required. 
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Examples 

To  create  a  zone  alias: 


switch; 

: admin> 

alicreate 

" arrayl " , 

"2,32;    2,3  3; 

2,  34" 

switch: 

: admin> 

alicreate 

"array2 " , 

"21:00:00:20: 

37:0c:66 

:23" 

switch: 

: admin> 

alicreate 

" loopl " , 

"4, 5 [0x02];  6, 

7 [ OxEF ] ; 

5,4" 

See  also 

aliAdd 
aliDelete 
aliRemove 
aliShow 
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ali  Delete 


Deletes  a  zone  alias. 


Synopsis 


alidelete " aliName 


Availability 


admin 


\^)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 


Use  this  command  to  delete  a  zone  alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Description 


Operands 


This  command  has  the  following  operand: 


aliName 


Specify  the  name  of  zone  alias  to  be  deleted.  This 
operand  must  be  enclosed  in  quotation  marks.  This 
operand  is  required. 


Examples 


To  delete  the  zone  alias  array2: 


switch : admin>  alidelete  "array2 


See  also 


ali Add 


aliCreate 


aliRemove 


aliShow 
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a  I  i  Remove 

Removes  a  member  from  a  zone  alias. 

Synopsis 

aliremove  "aliName" ,   "member;  member" 

Availability 

admin 


\^)f  NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
b— I    Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  zone  alias. 
If  all  members  are  removed,  the  zone  alias  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


This  command  has  the  following  operands: 


"aliName" 


member 


Specify  the  name  of  the  zone  alias  to  have  members  removed,  in 
quotation  marks.  This  operand  is  required. 

Specify  a  member  or  list  of  members  to  be  removed  from  the 
alias,  in  quotation  marks,  separated  by  semicolons.  An  alias 
member  can  be  specified  by  one  or  more  of  the  following 
methods: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area 
numbers  for  ports  using  the  switchShow  command. 

•  WWN 


•    QuickLoop  AL_PAs 

This  operand  is  required.  The  member  list  is  located  by  an  exact 
string  match;  therefore,  it  is  important  to  maintain  the  order 
when  removing  multiple  members.  For  example,  if  a  zone  alias 
contains  "1,2;  1,3;  1,4",  then  removing"  1 ,3;  1,4"  succeeds  but 
removing  "1,4;  1,3"  fails. 
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Examples 

Remove  a  world  wide  name  from  "arrayl  ": 


switch; 

: admin> 

aliremove 

" arrayl " , 

"3,5" 

switch; 

: admin> 

aliremove 

" arrayl " , 

"21:00:00:20:37:0c:76:8c" 

switch; 

:  admin> 

aliremove 

" arrayl " , 

" OxEF " 

See  also 

aliAdd 
aliCreate 
aliDelete 
aliShow 
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aliShow 


Displays  zone  alias  information. 


Synopsis 

alishow  ["pattern"  ]  [,  mode] 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 


If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  zone  alias  names;  those  that  match  in  the 
defined  configuration  are  displayed. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Description 


Use  this  command  to  display  zone  configuration  information. 


Operands 


This  command  has  the  following  optional  operands: 


pattern 


A  POSIX-style  regular  expression  used  to  match  zone  alias 
names.  This  operand  must  be  enclosed  in  quotation  marks. 
Patterns  can  contain: 


Question  mark  (?),  which  is  a  placeholder  for  any  single 
character 


Asterisk  (*),  which  is  a  placeholder  for  any  string  of 
characters 


Ranges,  which  are  a  placeholder  for  any  character  within  the 
range.  Ranges  must  be  enclosed  in  brackets:  for  example, 
[0-9]  or  [a-f]. 


mode 


Specify  0  to  display  the  contents  of  the  transaction  buffer  (the 
contents  of  the  current  transaction),  or  specify  1  to  display  the 
contents  of  the  flash  memory.  The  default  value  is  0 


If  no  parameters  are  specified,  all  zone  configuration  information  (both  defined  and  effective)  is 
displayed.  See  cf  gShow  for  a  description  of  this  display. 


Examples 


To  display  all  zone  aliases  beginning  with  "arr": 


switch : admin>  alishow  "arr* 


alias:   arrayl     21 : 00 : 00 : 20 : 37 : 0c : 76 : 8c 


alias:   array2     21 : 00 : 00 : 20 : 37 : 0c : 66 : 23 
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aliAdd 
aliCreate 
aliDelete 
aliRemove 


Fabric  OS  command 


apt  Pol  icy 

Changes  or  displays  the  Advanced  Performance  Tuning  (APT)  policy. 

Synopsis 

aptpolicy  [policy] 

Availability 

admin 

Description 

Use  this  command,  which  changes  several  internal  parameters,  to  change  the  performance  algorithm  on 
the  switch.  (A  detailed  performance-tuning  discussion  is  beyond  the  scope  of  this  manual.)  The  default 
parameters  are  optimal  for  most  SAN  applications;  typically,  customers  do  not  need  to  use  this 
command. 

When  used  with  no  arguments,  this  command  displays  a  list  of  APT  policies  supported  on  this  switch,  as 
well  as  the  current  policy.  This  can  be  done  at  any  time. 

The  switch  must  be  disabled  before  using  this  command  to  change  the  current  policy. 

Operands 

This  command  has  the  following  operand: 

policy  Specifies  the  new  APT  policy.  The  following  polices  are  supported: 

•  Port-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 

•  Ingress  port  on  which  the  frame  was  received 

•  Destination  domain  for  the  frame 

The  chosen  path  remains  the  same  if  Dynamic  Load  Sharing  (DLS)  feature  is 
not  enabled.  If  DLS  is  enabled,  then  a  different  path  may  be  chosen  on  a 
fabric  event.  See  dlsSet  for  the  definition  of  a  fabric  event. 

This  policy  may  provide  better  ISL  utilization  when  there  is  little  or  no 
oversubscription  of  the  ISLs. 

Note  that  static  routes  are  supported  only  with  this  policy. 

•  Device-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 

•  Ingress  port  on  which  the  frame  was  received 

•  FC  address  of  the  source  fabric  device  (SID)  for  this  frame 

•  FC  address  of  the  destination  fabric  device  (DID)  for  this  frame 

This  policy  allows  for  better  utilization  of  the  available  paths  as  I/O  traffic 
between  different  (SID,  DID)  pairs  can  use  different  paths.  All  frames  received 
on  a  ingress  port  with  the  same  (SID,  DID)  parameters  takes  the  same  path 
unless  there  is  a  fabric  event.  See  dlsSet  for  the  definition  of  a  fabric  event. 

This  policy  does  not  support  static  routes.  DLS  always  is  enabled  and  the  DLS 
setting  cannot  change  with  this  policy. 
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•    Exchange-based  routing  policy 

With  this  policy,  the  path  chosen  for  an  ingress  frame  is  based  on: 
Ingress  port  on  which  the  frame  was  received 

•  FC  address  of  the  SID  for  this  frame 

•  FC  address  of  the  DID  for  this  frame 

•  FC  Originator  Exchange  ID  (OXID)  for  this  frame 

This  policy  allows  for  optimal  utilization  of  the  available  paths  as  I/O  traffic 
between  different  (SID,  DID,  OXID)  pairs  can  use  different  paths.  All  frames 
received  on  a  ingress  port  with  the  same  (SID,  DID,  OXID)  parameters  takes  the 
same  path  unless  there  is  a  fabric  event.  See  dlsSet  for  the  definition  of  a 
fabric  event. 

This  policy  does  not  support  static  routes.  DLS  always  is  enabled  and  the  DLS 
setting  cannot  change  with  this  policy. 

Examples 

To  display  the  current  policy  and  then  change  it  from  an  exchange-based  to  a  device-based  policy: 


switch: admin>  aptpolicy 

U.-L -L  till  U     irU-L-l-^y  .  j 

3:  Default  Policy 
1:   Port  Based  Routing  Policy 
2 :  Device  Based  Routing  Policy 
3 :  Exchange  Based  Routing  Policy 

switch :admin>  aptpolicy  2 

Switch  must  be  disabled  in  order  to  modify 
parameter.  To  disable  the  switch,  use  the 

this  configuration 
switchDisable "  command. 

switch :admin>  switchdisable 

switch : admin>  aptpolicy  2 
Policy  updated  successfully. 

switch : admin>  switchenable 

switch :admin>  aptpolicy 
Current  Policy:  2 

3:  Default  Policy 
1:   Port  Based  Routing  Policy 
2 :  Device  Based  Routing  Policy 
3 :  Exchange  Based  Routing  Policy 
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See  also 

dlsReset 
dlsSet 
dlsShow 
switchDi sable 
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authUtil 


Displays  and  sets  the  authentication  configuration. 

Synopsis 

authutil  [--show] [--set  value] 

Availability 

admin 

Description 

Use  this  command  to  display  and  set  local  switch  authentication  parameters.  Use  --set  to  change 
authentication  parameters,  such  as  protocol  and  Diffie-Hellman  group  (DH  group),  which  saves  new 
configuration  persistently.  Authentication  process  uses  the  protocol  that  is  set  using  this  command. 

When  no  protocol  is  set,  the  default  setting  of  f  cap,  dhchap  is  used.  The  default  setting  of  "  *  "  (for 
example,  0,1,2,3,4)  is  used  when  no  group  is  set.  The  new  configuration  is  effective  with  the  next 
authentication  request. 

Use  --show  to  display  the  current  authentication  configuration  of  the  switch.  Use  the  portShow 
command  to  display  the  authentication  type  and  associated  parameters,  if  applicable,  used  on  the  port  at 
port  online  or  when  enabling  security,  whichever  occurs  last. 


NOTE:   A  security  license  is  required  to  run  this  command  in  nonsecure  as  well  as  secure  mode. 


Operands 

This  command  has  the  following  operands: 

--show  Displays  local  authentication  configuration. 

set  Modifies  authentication  configuration.  Values  include: 

-a  Sets  authentication  protocol.  Specify  f  cap  to  set  only  FCAP 

authentication,  dhchap  to  set  only  DH-CHAP  authentication, 
and  all  to  set  both  FCAP  and  DH-CHAP  (default).  When 
authentication  is  set  to  all,  implicit  order  is  FCAP  followed 
by  DH-CHAP;  for  example,  in  authentication  negotiation 
FCAP  is  given  priority  over  DH-CHAP  on  the  local  switch, 
however  a  responder  can  still  select  DH-CHAP. 

-g  Sets  DH  group.  Values  0  to  4  and  "  *  "  are  valid  values.  DH 

group  0  is  called  NULL  DH.  A  user  can  select  other  groups 
between  1  and  4.  Each  DH  group  specifies  a  key  size  and 
associated  parameters  implicitly.  Higher  group  value 
provides  stronger  cryptography  and  higher  level  of  security 
in  authentication  protocol.  When  DH  group  is  set  to  a 
specified  value,  only  that  DH  group  is  enabled  in 
authentication.  Specifying  "  *  "  as  a  group  enables  all  DH 
groups  0,  1,2,  3,  and  4,  in  that  order;  for  example,  in 
authentication  negotiation  NULL  DH  is  given  priority  over 
other  groups,  however  a  responder  can  still  select  other  DH 
group. 

Without  any  specified  operands,  the  command  displays  the  usage. 
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Examples 

To  display  authentication  configuration  on  the  switch: 

switch : admin>  authutil  --show 

AUTH  TYPE  HASH  TYPE  GROUP  TYPE 


dhchap  shal , md5  0,1,2,3,4 

To  set  DH-CHAP  as  authentication  protocol: 

switch : admin>  authutil  --set  -a  dhchap 
Authentication  is  set  to  dhchap. 

To  set  both  protocols  in  order  of  f  cap,  dhchap: 

switch : admin>  authutil  --set  -a  all 
Authentication  is  set  to  f cap, dhchap. 


To  set  DH  group  3: 


switch : admin>  authutil  • 

--set  -g  3 

DH  Group  was  set  to  3 . 

To  set  all  DH  groups  to  be  specified  in  auth  negotiate  in  order  of  0,  1,  2,  3,  and  4: 


switch : admin>  authutil  --set  -g  "*" 
DH  Group  is  set  to  0,1,2,3,4 

See  also 

portShow 
secAuthSecret 
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backplaneTest 

Tests  the  backplane  connection  for  a  multiple-blade  configured  system. 

Synopsis 

backplanetest  [--slot  number]  [-passcnt  count]  [-payload  value]  [-pat 
type] [-ports  itemlist]  [-[-verbose  mode] 

Availability 

admin 


Description 

Use  this  command  to  verify  the  backplane  connection  for  each  blade  through  the  backend  external  (BE) 
ports.  This  command  can  run  only  on  a  multiple-blade  configured  system.  It  assumes  that  all  blades 
available  on  the  specified  switch  have  passed  the  blade  diagnostics  tests.  This  command  verifies  the 
backplane  connection  by  using  a  functional  blade's  frame  transmitter  and  receiver  features. 


r2^f  NOTE:  No  other  diagnostic  can  be  executed  until  this  test  is  completed.  This  command  is  supported  on 
t£l    the  SAN  Switch  2/8V,  SAN  Switch  2/1 6V,  SAN  Switch  2/32,  Core  Switch  2/64,  and  SAN  Director 

2/1  28.  This  command  is  not  supported  on  the  4/16  SAN  Switch,  SAN  Switch  4/32  and  4/256  SAN 

Director,  which  use  the  Condor  ASIC. 


Operands 

This  command  has  the  following  operands: 

--slot  number  Specifies  the  slot  on  which  the  diagnostic  operates.  The  ports  specified  are 

relative  to  this  slot  number. 

-passcnt  count  Specifies  the  number  of  times  to  perform  this  test.  The  default  value  is  1 . 

-payload  value  Specifies  the  byte  size  of  the  test  frame  payload.  The  payload  size  must  be 

in  multiples  of  4,  and  the  minimum  size  is  1 6.  The  default  value  is  5 1 2 
bytes. 

-pat  type  Specifies  the  test-pattern  type  to  use  in  the  test  frame  payload.  Twenty  types 

of  predefined  patterns  are  provided  with  the  test;  the  default  is  jCRPAT 
(type=17).  Use  dataTypeShow  to  display  the  pattern  types  supported 
with  backplaneTest. 

-ports  itemlist         Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in  the 

specified  slot  are  used.  See  itemList  for  further  details 

-verbose  mode  Specifies  verbose  mode.  If  specified  with  a  nonzero  value,  this  mode 

displays  the  test  progress  in  detail.  The  default  value  is  to  disable  the  mode. 
This  operand  is  optional. 
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Examples 

To  test  backplane  connections  on  an  HP  StorageWorks  Director: 


switch : admin>  backplanetest  -ports  1/16,   18,   20  -payload  2048  -verbose  1 


Running  backplanetest 


Test  frame  info  for  Backplane  Connection  Test: 


#  of  frames : 


1 


sid  data: 


Oxfff ffd 


did  data: 


Oxfff ffd 


payload  size 


2  048  bytes 


Test  Complete:  backplanetest  Pass  1  of  1 


Duration  0  hr,    0  min  &  1  sec  (0:0:1:715). 


passed. 


Diagnostics 


When  this  command  detects  failures,  the  subtest  might  report  one  or  more  of  the  following  error 
messages: 

DATA 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


See  also 


itemList 
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backport 


Tests  for  backend  ASIC-to-ASIC  links. 


Synopsis 


backport  [-nframes  count]  [-ports  itemlist]  [-lb_mode  mode]  [-fr_type 
type] [-extonly  mode] 


Availability 


admin 


Description 

Use  this  command  to  test  the  backplane  routing  and  virtual  channel  (VC)  allocation.  This  test  applies  to 
single  blade  as  well  as  multiblade  systems. 

The  following  items  are  tested: 

•  Proper  backend  port  domain  routing  setup  such  that  every  user  port  has  a  valid  path  to  every  other 
user  port.  If  a  valid  path  does  not  exist  between  any  two  user  ports,  that  path  will  fail  to  transmit  the 
first  frame  between  the  two  ports. 

•  Proper  virtual  channel  mapping  such  that  an  arbitrarily  large  number  of  frames  might  be  transmitted 
without  running  out  of  credit.  If  the  VC  credit  mapping  is  not  correct  then  the  test  will  fail  after  enough 
frames  have  been  sent  to  exhaust  the  initial  credit. 

•  Proper  trunking  of  backend  ports.  The  frames  send  in  bursts.  If  the  trunking  is  not  set  up  properly,  the 
burst  of  frames  do  not  arrive  in-order. 

•  ASIC  errors  along  each  path.  The  test  checks  for  CRC  and  ENC  errors  for  each  port  used  between  the 
source  and  destination  ports  to  help  isolate  failures.  It  also  checks  that  each  member  of  every  trunk 
group  along  the  path  has  sent  or  received  at  least  one  frame. 

Area  routing  between  user  ports  is  not  tested.  Use  of  this  command  assumes  that  the  same  database  is 
used  for  domain  and  area  routes;  therefore,  domain  results  are  indicative  of  area  operation. 


p2)f  NOTE:    Virtual  channel  mapping  is  not  tested  if  -extonly  is  set  to  1 . 


Operands 


This  command  has  the  following  options: 


-lb_mode  mode 


-nframes  count 


ports  itemlist 


Specifies  the  number  of  frames  per  port  to  send.  The  test  runs  until  the 
specified  number  of  frames  has  been  transmitted  on  each  port.  The 
total  number  of  frames  that  this  command  circulates  is  determined  at 
run  time.  The  default  value  is  10  and  the  minimum  value  is  3.  Any 
value  less  than  the  minimum  is  ignored  and  the  minimum  value  is  used. 

Specifies  a  list  of  user  ports.  The  default  value  is  all  user  ports.  See 
itemList  for  more  information. 

Selects  the  loopback  point  for  the  test.  By  default,  backport  uses 
internal  loopback. 


Mode  Description 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 
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Specifies  the  frame  type  to  send.  The  default  value  is  1 . 

Type  Description 

0  Single  frame 

1  spinfab  frames 

2  spinfab  1 K  frames 

Specifies  externa  I -test-only  mode.  The  default  value  is  0,  which  disables 
this  mode.  This  command  normally  sends  bursts  of  frames  from  each 
port  under  test  to  every  other  port  in  the  list.  With  -extonly  mode  set  to 
1 ,  the  command  sends  only  one  burst  of  frames  to  each  port  from  each 
ASIC  pair-to-ASIC  pair  link.  This  tests  all  of  the  external  connections 
with  only  K  *  N  frames  instead  of  the  NA2  frames  required  in  all-to-all 
mode. 

This  mode  is  intended  to  be  used  in  ESS/burn-in  testing  to  optimize  test 
time,  backport  tests  only  the  external  connections  between  each 
ASIC  pair.  txdPath  is  used  to  test  the  internal  ASIC  pair-to-ASIC  pair 
paths.  The  values  are: 

0  Send  frames  from  all  ports  to  all  other  ports. 

1  Send  only  one  burst  of  frames  to  each  link. 

Examples 

To  test  for  backend  ASIC  pair  links: 


switch : admin>  backport 

-ports  1/1-1/3  -nframes  10 

One  moment  please  . . . 

backport  running. . . 

backport:  Completed  840 

frames,   status:  passed. 

Diagnostics 

When  the  command  detects  failures,  the  test  can  report  one  or  more  of  the  following  error  messages: 

ERR_STAT 

ERR_STATS 

INIT 

PORT_DIED 

PORT_STOPPED 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

crossPortTest 
itemList 

portLoopbackTest 
spinFab 
spinSilk 
txdPath 


-fr_type  type 


-extonly  mode 


Fabric  OS  5.x  command  reference  guide  57 


bannerSet 

Sets  the  banner  on  the  local  switch. 

Synopsis 

bannerset  [banner] 

Availability 

admin 

Description 

Use  this  command  to  set  the  banner  on  the  local  switch. 

The  banner  is  a  string  of  alphanumeric  characters.  It  is  displayed  whenever  a  user  tries  to  log  in  to  a 
switch. 

The  banner  can  be  created  using  the  banner  operand  or  by  entering  the  bannerSet  command  without 
an  operand,  making  the  session  interactive. 

If  you  enter  the  banner  text  using  the  interactive  method,  the  valid  length  is  1022  characters.  If  the  banner 
text  length  exceeds  the  maximum  allowed,  the  software  truncates  the  input.  To  close  the  banner  text  string, 
enter  a  period  at  the  beginning  of  a  new  line. 

Operands 

This  command  has  the  following  operand: 

banner  Specify  a  text  string  to  be  displayed  when  a  user  logs  in.  If  you 

enter  the  banner  text  using  the  banner  operand,  the  valid 
length  is  1  16  characters.  This  operand  is  optional. 

Examples 

To  set  a  new  banner  for  a  switch: 

switch : admin>  bannerset   "My  banner" 

switch : admin>  bannerSet 

Please  input  context  of  security  banner   (press  " . "  RETURN  at  the 
beginning  of  a  newline  to  finish  input) :   Do  not  log  into  this 
switch  if  you  are  not  an  authorized  administrator. 


See  also 

bannerShow 
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bannerShow 

Displays  the  banner  text. 

Synopsis 

bannershow 

Availability 

admin 

Description 

Use  this  command  to  display  the  contents  of  the  banner. 

Operands 

none 

Examples 

To  display  the  banner  for  a  switch: 

switch : admin>  bannershow 
Banner : 

Do  not  log  into  this  switch  if  you  are  not  an  authorized  administrator. 

See  also 

bannerSet 
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bcastShow 


Displays  broadcast  routing  information. 


Synopsis 

bcastshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  broadcast  routing  information  for  all  ports  in  the  switch.  The  broadcast 
routing  information  indicates  all  ports  that  are  members  of  the  broadcast  distribution  tree:  ports  that  are 
able  to  send  and  receive  broadcast  frames. 

Normally,  all  FPorts  and  FL  Ports  are  members  of  the  broadcast  distribution  tree.  The  broadcast  path 
selection  protocol  selects  the  E_Port  members  of  this  tree  in  a  manner  designed  to  prevent  broadcast 
routing  loops. 

The  following  fields  appear: 

Group  The  multicast  group  ID  of  the  broadcast  group  (always  256) 

Member  Ports  A  map  of  all  ports  in  broadcast  tree 

Member  ISL  Ports  A  map  of  all  E  Ports  in  broadcast  tree 

The  broadcast  routing  information  for  the  ports  is  displayed  as  a  set  of  hexadecimal  bit  maps.  Each  bit  in 
a  bit  map  represents  a  port,  with  the  least  significant  bit  in  each  row  representing  port  0,  32,  64,  and  so 
on.  For  more  information  on  reading  hexadecimal  bit  maps,  see  the  HP  StorageWorks  Fabric  OS  5.x 
administrator  guide. 


ptyf  NOTE:    The  output  from  this  command  varies,  depending  on  switch  type. 


Operands 


none 


Examples 


To  display  the  broadcast  routing  information  for  all  ports  in  the  switch: 


switch : admin>  bcastShow 


Group    Member  Ports 


Member  ISL  Ports 


256 


0x00012083 


0x00002080 


0x00000440 


0x00000400 


0x00770000 


0x00700000 


0x00008200 


0x00000000 


0x00000001 


0x00000000 
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In  the  previous  example,  from  a  switch  with  1  28  ports,  the  member  ports  consist  of  ports  7,  1  3,  42,  84, 
85,  and  86.  The  final  Member  Ports  bit  set  represents  the  embedded  port  (frames  sent  to  be  handled  by 
firmware)  and  is  typically  set. 

See  also 

portRouteShow 
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bladeBeacon 

Sets  blade  beaconing  mode  on  or  off. 

Synopsis 

bladebeacon   [ slotnumber]  mode 

Availability 

admin 


f2^>  NOTE:   This  command  is  available  only  on  the  HP  StorageWorks  SAN  Directors. 


Description 

Use  this  command  to  enable  or  disable  blade  beaconing  or  to  display  the  current  beaconing  mode  for 
one  blade. 

When  beaconing  is  enabled,  the  port  LEDs  flash  amber  in  a  running  pattern  from  port  0  through  port  1 5 
and  back  again.  The  pattern  continues  until  the  user  turns  it  off.  This  can  be  used  to  locate  a  physical  unit. 

Beaconing  mode  only  takes  over  the  port  LEDs;  it  does  not  change  the  switch's  functional  behavior.  The 
normal  flashing  LED  pattern  (associated  with  an  active,  faulty,  or  disabled  port,  for  example)  is  suppressed 
and  only  the  beaconing  pattern  is  displayed.  If  a  diagnostic  frame-based  test  (such  as 

portLoopbackTest,  crossPortTest,  or  spinSilk)  is  executed,  the  two  LED  patterns  are 
interwoven.  The  diagnostic  test  flickers  the  LEDs  green  and  the  beaconing  mode  runs  the  LEDs  amber. 

The  switchShow  command  can  be  used  to  display  if  the  status  of  blade  beaconing  mode  is  on  or  off. 

Operands 

This  command  has  the  following  operands: 

slotnumber  Specifies  the  slot  number  to  enable  bladeBeacon. 

mode  Specifies  a  value  of  1  to  set  beaconing  mode  on.  Specifies  a  value  of  0 

to  set  beaconing  mode  off.  This  operand  is  optional;  if  omitted,  the 
current  mode  appears. 

Examples 

To  enable  beaconing  on  slot  3,  display  the  beaconing  mode,  the  disable  the  slot: 


swi  tch : admin> 

bladebeacon 

2  1 

swi  tch : admin> 

bladebeacon 

2 

value  =  1 

switch : admin> 

bladebeacon 

2  0 

See  also 

switchShow 
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bladeDisable 


Disables  all  user  ports  on  a  blade. 


Synopsis 

bladedisable   [ slotnumber] 

Availability 

admin 


Description 

Use  this  command  to  disable  all  user  ports  on  a  blade.  All  Fibre  Channel  ports  are  taken  offline.  If  the 
switch  was  connected  to  a  fabric  through  this  blade,  the  remaining  switches  reconfigure,  and  this  switch 
will  configure  based  on  the  other  blade  ports. 

The  blade  must  be  disabled  before  making  configuration  changes  or  before  running  many  of  the 
diagnostic  tests. 

The  blade  does  not  need  to  be  disabled  before  rebooting  or  powering  off. 

Observe  and  verify  the  disable  process  by  watching  the  front  panel  LEDs  change  to  slow  flashing  yellow 
as  each  port  of  the  blade  disables. 


NOTE:  A  blade  cannot  be  disabled  or  enabled  when  the  switch  is  disabled  or  when  the  blade  itself  is 
disabled  (using  slotof  f),  faulted,  powered  off,  or  running  diagnostics. 


Operands 

This  command  has  the  following  operand: 

slotnumber  Specifies  the  slot  number  on  which  the  ports  are  to  be  disabled. 
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Examples 

To  disable  blade  2  and  then  verify: 


admin>  bladedisable  2 

Blade  2 

is 

being 

disabled. 

. . Done 

switch: 

admin>  slotshow 

Slot 

Blade  Type 

ID 

Status 

1 

SW 

BLADE 

2 

ENABLED 

2 

sw 

BLADE 

2 

ENABLED  (User  Ports  Disabled) 

3 

SW 

BLADE 

2 

ENABLED 

4 

sw 

BLADE 

2 

ENABLED 

5 

CP 

BLADE 

1 

ENABLED 

6 

CP 

BLADE 

1 

ENABLED 

7 

sw 

BLADE 

2 

ENABLED 

8 

sw 

BLADE 

2 

ENABLED 

9 

sw 

BLADE 

2 

ENABLED 

10 

sw 

BLADE 

2 

ENABLED 

See  also 

bladeEnable 
portDisable 
portEnable 
slotOf f 
switchShow 
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bladeEnable 


Enables  all  user  ports  on  a  blade. 

Synopsis 

bladeenable   [ slotnumber] 

Availability 

admin 

Description 

Use  this  command  to  enable  all  user  ports  on  a  blade.  All  Fibre  Channel  ports  within  the  blade  that  did 
not  fail  the  power-on  self-test  (POST)  are  enabled  (except  for  persistently  disabled  ports);  they  might  come 
online  if  connected  to  a  device  or  remain  offline  if  disconnected. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  If  this  switch  remains  the  principal  switch  at  the 
end  of  the  countdown,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then 
this  switch  becomes  a  subordinate  switch  and  accepts  a  domain  ID  from  the  principal.  See  FC-SW  for  a 
complete  description  of  this  process. 

Observe  and  verify  the  enable  process  by  watching  the  front-panel  LEDs  change  from  slow  flashing  amber 
as  each  port  enables.  The  LEDs  change  to  green  for  online  ports,  unlighted  for  disconnected  ports,  or 
amber  for  ports  that  do  not  initialize. 


f2^f  NOTE:  A  blade  cannot  be  disabled  or  enabled  when  the  switch  is  disabled  or  when  the  blade  itself  is 
b— I    disabled  (using  slotof  f),  faulted,  powered  off,  or  running  diagnostics. 

Persistently  disabled  ports  are  not  enabled  by  this  command. 


Operands 

This  command  has  the  following  operand: 

slotnumber  Specifies  the  slot  number  to  be  enabled. 

Examples 


To  display  the 

slot  status,  ena 

ble  the 

user  ports  in  slot  4,  and  verify  the  setting: 

switch: 

admin>  slotshow 

Slot 

Blade  Type 

ID 

Status 

1 

SW  BLADE 

2 

ENABLED 

2 

UNKNOWN 

VACANT 

3 

UNKNOWN 

VACANT 

4 

SW  BLADE 

2 

ENABLED  (User  Ports  Disabled) 

5 

CP  BLADE 

1 

ENABLED 

6 

CP  BLADE 

1 

ENABLED 

7 

SW  BLADE 

2 

ENABLED 

(continued  on  next 

page) 
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8 

UNKNOWN 

VACANT 

9 

UNKNOWN 

VACANT 

J.  u 

T  TKTTT  TVT/"lTnTl\T 

UlMiMMUWIM 

\  7  a  c  a  "ntt1 
V  ACrtlN  1 

switch: 

admin>  bladeenable 

4 

slBlade  4  is  being  enabled. . .Done 

switch: 

admin>  slotshow 

Slot 

Blade  Type  ID 

Status 

1 

SW  BLADE  2 

ENABLED 

2 

UNKNOWN 

VACANT 

3 

UNKNOWN 

VACANT 

4 

SW  BLADE  2 

ENABLED 

5 

CP  BLADE  1 

ENABLED 

6 

CP  BLADE  1 

ENABLED 

7 

SW  BLADE  2 

ENABLED 

8 

UNKNOWN 

VACANT 

9 

UNKNOWN 

VACANT 

10 

UNKNOWN 

VACANT 

See  also 

bladeDi sable 

portDisable 

portEnable 

slotOf f 

slotOn 

switchShow 
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burninErrClear 


Clears  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 


Synopsis 

burninErrClear  slotNum 

Availability 

admin 

Description 

Use  this  command  to  clear  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 


NOTE:    HP  StorageWorks  recommends  running  the  burninErrClear  command  prior  to  running 

diagSetBurnin  and  diagSetCycle. 


Operands 


This  command  has  the  following  operand: 


slotNum 


A  nonzero  value  that  specifies  the  slot  number  from  which  to 
clear  burn-in  errors. 


Examples 


To  clear  burn-in  errors  from  slot  2. 


switch : admin>  burninErrClear  2 


See  also 


burninErrShow 
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burninErrShow 


Displays  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Synopsis 

burninErrShow  slotNum 

Availability 

all  users 

Description 

Use  this  command  to  display  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

Operands 

This  command  has  the  following  operand: 

slotNum  A  nonzero  value  that  specifies  the  slot  number  from  which  to 

display  burn-in  errors. 

Examples 

To  display  burn-in  errors  from  slot  2: 

switch : admin>  burninErrShow  2 

See  also 

burninErrClear 
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burninLevel 

Sets  the  diagnostics  burn-in  level. 

Synopsis 

burninlevel    [   level    |    -show  ] 

Availability 

admin 


Description 

Use  this  command  to  select  or  display  the  burn-in  level.  When  the  burn-in  level  is  set  to  a  value  other  than 
0,  the  diagnostic  daemon  program  performs  burn-in  testing  in  place  of  the  power-on  self-test  (POST)  phase 
II  each  time  a  switch  blade  is  powered  on.  The  mode  becomes  active  as  soon  as  this  command  is 
executed  so  that  it  does  not  require  a  reboot  to  take  effect. 

When  a  burn-in  level  other  than  0  is  selected,  actual  behavior  is  determined  by  the  configuration  of  the 
diagnostics  daemon  and  the  burn-in  scripts  run. 

A  useful  application  of  this  command  is  to  store  errors  on  the  local  persistent  error  storage  on  which  the 
error  occurs.  This  happens  when  the  burn-in  level  is  other  than  0.  This  preserves  the  errors  prior  to 
returning  a  board  for  service.  For  multibladed  products,  this  is  the  independent  blade,  and  for 
fixed-port-count  products,  this  is  the  chassis-persistent  storage.  The  error  logs  are  viewed  using  the 

burninErrShow  command. 

Operands 

The  following  are  optional: 

level  The  burn-in  level  is  set  to  this  value. 

-show  If  specified,  or  if  level  is  not  specified,  the  current  burn-in  level 

setting  appears. 

Examples 

To  set  the  diagnostic  burn-in  level: 


switch : admin>  burninlevel  -show 
Burnin  level  is  0 . 


See  also 

burninErrShow 
diagDisablePost 
diagEnablePost 
diagSetBurnin 
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burninStatus 

Displays  the  diagnostics  burn-in  status. 

Synopsis 

burninstatus    [ [   --slot  ]    slotnumber  ] 

Availability 

admin 

Description 

Use  this  command  to  display  the  burn-in  status  of  each  blade  in  the  system.  The  output  contains  the  slot, 
state,  current  run  number,  current  command  in  the  run,  total  commands  in  a  run,  and  the  burn-in  script 
name. 

Operands 

The  following  operands  are  optional: 

--slot  slotnumber  Optional  specify  to  get  the  burn-in  status  of  a  single  slot.  If  not 

specified,  all  slots  are  displayed. 

Examples 

To  display  the  burn-in  status  for  all  slots: 


switch: 

admin>  burninstatus 

Slot 

State  Status 

Run 

Cmd 

TotCmds 

PID 

Script 

1 

ABORT  PASS 

3 

18 

41 

916 

burnin 

2 

ABORT  PASS 

3 

18 

41 

920 

burnin 

3 

ABORT  PASS 

3 

18 

41 

923 

burnin 

4 

ABORT  FAIL 

3 

11 

34 

926 

burnin 

To  display  the 

burn-in  status  for  slot  3: 

switch: 

admin>  burninstatus  -- 

slot  3 

Slot 

State  Status 

Run 

Cmd 

TotCmds 

PID 

Script 

3 

ABORT  PASS 

3 

18 

41 

923 

burnin 

See  also 

diagSetBurnin 
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camTest 

Verifies  QuickLoop's  Content  Addressable  Memory  (CAM)  SID  translation. 

Synopsis 

camtest   [--slot  slotnumber]  [-passcnt  count] [-txport  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  the  CAM  is  functionally  OK  by  performing  hit  and  miss  tests.  The  CAM  is 
used  by  QuickLoop  to  translate  the  SID. 

When  a  CAM  is  presented  with  a  data,  it  checks  if  the  data  is  present  in  its  memory.  A  hit  means  the  data 
is  found  in  the  CAM.  A  miss  means  the  data  is  not  found. 

In  this  test,  the  CAM  is  filled  with  four  kinds  of  data  patterns: 

•  A  walking  1 

•  A  walking  0 

•  A  random  pattern 

•  An  inverted  version  of  the  random  pattern  above 

Once  filled  with  each  of  the  patterns  above,  a  frame  is  sent  and  looped  back  internally.  If  a  hit  is  expected 
(when  the  random  or  inverted  random  pattern  is  used)  the  original  SID  in  the  frame  transmitted  is  received 
translated  with  the  domain  and  area  fields  of  the  SID  zeroed.  If  a  miss  is  expected  (when  the  walking  1  or 
walking  0  pattern  is  used)  the  original  SID  in  the  frame  transmitted  is  received  unchanged. 

"2£b?  NOTE:   This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using 
the  switchDisable  command.  This  command  is  supported  on  the  SAN  Switch  2/8V,  SAN  Switch 
2/1 6V,  SAN  Switch  2/32,  Core  Switch  2/64,  and  SAN  Director  2/1 28.  This  command  is  not  supported 
on  the  4/16  SAN  Switch,  SAN  Switch  4/32  and  4/256  SAN  Director,  which  use  the  Condor  ASIC. 


Operands 

This  command  has  the  following  operand: 

--slot  slotnumber     Specifies  the  slot  number  on  which  the  diagnostic  will  operate. 

The  ports  specified  will  be  relative  to  this  slot  number.  The  default 
is  set  to  0  and  designed  to  operate  on  fixed-port-count  products. 

-passcnt  count  Specifies  the  number  of  times  to  perform  this  test.  The  default 

value  is  1 . 

-txport  itemlist       Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade 

ports  in  the  specified  slot  (-slot)  will  be  used.  See  itemList  for 
more  information. 
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Examples 

To  verify  CAM  is  functioning  correctly: 


switch: admin>  camtest  -txports  1/1 

Running  camtest   

Test  Complete:    "camtest"  Pass  1  of  1 
Duration  0  hr,    0  min  &  5  sec  (0:0:5:14). 
passed. 

Diagnostics 

When  failures  are  detected,  the  subtest  might  report  one  or  more  of  the  following  error  messages: 

DIAG-CAMFLTR 

DIAG-CAMINIT 

DIAG-CAMSID 

DIAG-CAMSTAT 

DIAG-CANTXMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

cross PortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sraraRetentionTest 


72     Fabric  OS  commands 


centralMemoryTest 


Tests  ASIC-pair  central  memory  operation. 


Synopsis 


centralraemorytest  [--slot  slotnumber]  [-passcnt  count] [-datatype 
type] [-ports  itemlist]  [-seed  value] 


Availability 


admin 


Description 

Use  this  command  to  execute  an  address  and  data  bus  verification  of  the  ASIC  SRAMs  that  serve  as  the 
central  memory. 


NOTE:   This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using 
b_ I    the  switchDisable  command.  This  command  is  supported  on  the  SAN  Switch  2/8V,  SAN  Switch 

2/1 6V,  SAN  Switch  2/32,  Core  Switch  2/64,  and  SAN  Director  2/1 28.  This  command  is  not  supported 
on  the  4/16  SAN  Switch,  SAN  Switch  4/32  and  4/256  SAN  Director,  which  use  the  Condor  ASIC. 


The  test  consists  of  six  subtests,  each  described  next. 
Built-in  self-repair  subtest 

The  built-in  self-repair  subtest  executes  the  built-in  self-repair  (BISR)  circuitry  in  each  ASIC.  The  BISR 
executes  its  own  BIST,  and  cells  found  to  be  bad  are  replaced  by  redundant  rows  provided  in  each  SRAM 
in  the  ASIC.  Once  the  cells  are  replaced,  the  BIST  is  executed  again. 

The  firmware  sets  up  the  hardware  for  the  BISR/BIST  operation  and  checks  the  results.  If  the  done  bit  in 
each  SRAM  is  not  set  within  a  time-out  period,  it  reports  the  DIAG-CMBISRTO.  If  any  of  the  SRAMs  within 
the  ASIC  fails  to  map  out  the  bad  rows,  its  fail  bit  is  set  and  the  DIAG-CMBISRF  error  generated. 

Data  read/write  subtest 

The  data  write/ read  subtest  executes  the  address  and  data  bus  verifications  by  running  a  specified  unique 
ramp  pattern  D  to  all  SRAMs  in  all  ASICs  in  the  switch.  When  all  SRAMs  are  written  with  pattern  D,  the 
SRAMs  are  read  and  compared  against  the  data  previously  written.  This  procedure  is  repeated  with  the 
complemented  pattern  ~D  to  ensure  that  each  data  bit  is  toggled  during  the  test. 

The  default  pattern  used  (by  POST  also)  is  a  QUAD  RAMP  with  a  seed  value  of  0. 
ASIC-to-ASIC  connection  subtest 


NOTE:    This  subtest  is  not  available  on  2  Gb/s-capable  switches. 


The  ASIC-to-ASIC  connection  subtest  verifies  that  any  port  can  read  the  data  from  any  of  the  ASICs  in  the 
switch,  thus  verifying  both  the  logic  transmitting  and  receiving  the  data  and  the  physical  transmit  data 
paths  on  the  main  board  connecting  all  the  ASICs  to  each  other. 

The  test  method  is  as  follows: 

1.  Fill  the  central  memory  of  all  ASICs  with  unique  frames. 

2.  Set  up  the  hardware  such  that  each  ASIC  is  read  by  all  of  the  ports  in  the  switch.  Data  received  is 
compared  against  the  frame  written  into  the  ASIC. 
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Port  0  reads  the  central  memory  in  ASIC  0. 
Port  1  reads  the  central  memory  in  ASIC  0. 
Port  14  reads  the  central  memory  in  ASIC  0. 
Port  15  reads  the  central  memory  in  ASIC  0. 
Port  0  reads  the  central  memory  in  ASIC  1 . 
Port  1  reads  the  central  memory  in  ASIC  1 . 
Port  14  reads  the  central  memory  in  ASIC  1 . 
Port  15  reads  the  central  memory  in  ASIC  1 . 
Port  15  reads  the  central  memory  in  ASIC  2. 
Port  15  reads  the  central  memory  in  ASIC  3. 

3.  Repeat  step  1  and  step  2  for  the  complemented  pattern. 

4.  Repeat  this  procedure  for  each  ASIC  pair  in  the  blade  under  test. 

The  pattern  used  is  generated  similarly  as  in  data  read/write  subtest  except  that  only  2112  bytes  are 
generated. 

Parity  error  subtest 

The  forced  bad  parity  error  subtest  verifies  that  a  bad  parity  can  be  detected,  its  error  flag  set,  and 
interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Write  64  bytes  with  bad  parity  to  all  ASICs  at  offset  0. 

3.  Read  each  of  the  ASIC  pairs  at  offset  0  and  check  that  the  error  and  interrupt  bits  are  set. 

4.  Repeat  step  1  through  step  3  for  offset  1  through  1  0. 

Buffer  number  error  subtest 

The  forced  bad  buffer  number  error  subtest  verifies  that  the  bad  buffer  number  in  the  data  packet  can  be 
detected  and  its  error  flag  and  interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Set  up  the  hardware  so  that  transmission  of  data  includes  a  bad  buffer. 

3.  For  each  of  the  1  1  possible  offsets  for  each  ASIC  X  in  the  switch: 

a.  Write  a  64-byte  pattern  in  the  central  memory. 

b.  Read  X  from  all  ASIC  Y  in  the  switch. 

c.  For  ASIC  X,  ensure: 

•  Interrupt  status  bits  are  set. 

•  The  error  type  is  buffer  number  error. 

•  The  port  number  in  error  is  the  receiver  port  (which  is  the  base  port  of  ASIC  Y). 

d.  Check  that  all  ASICs  besides  X  are  not  interrupted  or  flagged  with  an  error. 
Reading  the  error  register  clears  the  CMEM  interrupt  bit,  preparing  for  the  next  offset  to  test. 
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Chip  number  error  subtest 

The  forced  bad  chip  number  error  subtest  verifies  that  the  bad  buffer  number  in  the  data  packet  can  be 
detected  and  its  error  flag  and  interrupt  bits  set. 

The  test  method  is  as  follows: 

1 .  Clear  the  error  and  interrupt  bits  of  all  ASICs. 

2.  Set  up  the  hardware  so  that  transmission  of  data  includes  a  bad  buffer. 

3.  For  each  of  the  1 1  possible  offsets  for  each  ASIC  X  in  the  switch: 

a.  Write  a  64-byte  pattern  in  the  central  memory. 

b.  Read  X  from  all  ASIC  Y  in  the  switch. 

c.  For  all  ASIC  Y,  ensure: 

•  interrupt  status  bits  set. 

•  the  error  type  is  chip  number  error. 

•  the  port  number  in  error  is  the  receiver  port  (which  is  the  base  port  of  ASIC  Y). 
Reading  the  error  register  clears  the  CMEM  interrupt  bit,  preparing  for  the  next  offset  to  test. 

Operands 

This  command  has  the  following  operands: 

--slot  slotnumber     Specify  the  slot  number  on  which  the  diagnostic  will  operate. 

The  ports  specified  will  be  relative  to  this  slot  number.  The 
default  is  set  to  0  and  designed  to  operate  on  fixed  port-count 
products. 

-passcnt  count  Specify  the  number  of  test  passes  to  run.  By  default,  the  test  runs 

one  time. 

-datatype  type  Specify  the  type  of  data  pattern  to  use.  By  default,  type  9, 

QUAD  RAMP,  is  used.  For  a  complete  list  of  supported  data 
patterns,  run  the  dataTypeShow  command.  Some  common 
settings  are: 

1  BYTE  FILL  pattern 

2  WORD_FILL  pattern 

3  QUAD_FILL  pattern 

9  QUAD_RAMP  (Addr=Data)  pattern 

1  1         RANDOM  pattern 

-ports  i  temlist         Specify  a  list  of  blade  ports  to  test.  The  Ports  list  is  translated  into 

a  matching  Quad  list  before  the  test  is  run.  By  default,  all  the 
blade  ports  in  the  specified  slot  (-slot)  are  tested.  See 

itemList  for  more  information. 

-seed  value  Specify  the  data  pattern  seed  to  be  used.  The  default  seed  value 

is  0. 
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Examples 

To  test  the  ASIC  central  memory: 

switch : admin>  centralmemorytest  -ports  1/0-1/15 

Running  centralmemorytest   

Test  Complete:    "centralmemorytest"  Pass  1  of  1 

Duration  0  hr,    0  min  Duration  0  hr,    0  min  Duration  0  hr,    0  min  &  5  sec 
(0:0:5:412).    5   sec    (0:0:5:412).    5   sec  (0:0:5:412). 

passed. 

Diagnostics 

When  this  command  detects  failures,  each  subtest  can  report  one  or  more  of  the  following  error  messages: 
Subtest  2 

LCMEM_ERR 
LCMRS_ERR 
LCMTO_ERR 

Subtest  3 

CM_NO_BUF 
LCMEMTX_ERR 
LCMRS_ERR 
LCMTO_ERR 

Subtest  4 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

Subtest  5 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

Subtest  6 

BAD_INT 
CM_ERR_PTN 
CM_ERR_TYPE 
TIMEOUT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

camTest 

cmeraRetentionTest 
cmiTest 
cross PortTest 
itemList 
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portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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cfgActvShow 

Displays  current  zone  configuration  information. 

Synopsis 

cf gactvshow 

Availability 

all  users 


NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  display  the  effective  zone  configuration  information. 

The  current  configuration  is  a  single  zone  configuration  that  is  currently  in  effect.  The  devices  that  an 
initiator  sees  are  based  on  this  configuration.  The  effective  configuration  is  built  when  a  specified  zone 
configuration  is  enabled. 


'^f  NOTE:   When  security  is  enabled,  this  command  can  be  issued  on  any  switch  in  the  fabric. 


Operands 

none 

Examples 

To  display  the  effective  zone  configuration  information: 


switch : admin> 

cf gactvshow 

Effective 

configuration : 

cfg: 

c4 

zone : 

z3 

33:07:06 

05 

04 

03 

02 

01 

zone : 

z4 

44:01:23 

45 

67 

89 

aO 

be 

40:01:23 

45 

67 

89 

aO 

be 

See  also 

cf gClear 
cf gDelete 
cfgRemove 
cf gSave 
cf gShow 
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cfgAdd 

Adds  a  member  to  a  zone  configuration. 

Synopsis 

cfgadd  "cfgName",   "member;  member" 

Availability 

admin 


[?2hf  NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

This  command  has  the  following  required  operands: 

cfgName  Specifies  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specifies  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  add  two  new  zones  to  the  configuration  "Test_cfg": 


switch : admin>  cfgadd  "Test_cfg",    "redzone;  bluezone" 


See  also 

cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cfgEnable 
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cf gRemove 
cf gSave 
cf gShow 
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cfgClear 

Clears  all  zone  configurations. 

Synopsis 

cf gclear 

Availability 

admin 


[?2hf  NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  clear  all  zone  information  in  the  transaction  buffer.  All  defined  zone  objects  in  the 
transaction  buffer  are  deleted.  If  an  attempt  is  made  to  commit  the  empty  transaction  buffer  while  a  zone 
configuration  is  enabled,  you  are  warned  to  first  disable  the  enabled  zone  configuration  or  to  provide  a 
valid  configuration  with  the  same  name. 

After  clearing  the  transaction  buffer  using  the  cfgClear  command,  use  the  cfgDisable  command  to 
commit  the  transaction  and  then  disable  and  clear  the  zone  configuration  in  flash  memory  for  all  the 
switches  in  the  fabric. 

If  no  current  zoning  configuration  exists,  use  the  cfgSave  command. 


\^)f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  clear  all  zones  and  then  clear  flash  memory: 


switch : admin>  cf gclear 

The  Clear  All  action  will  clear  all  Aliases,   Zones,  FA  Zones 

and  configurations  in  the  Defined  configuration. 

Do  you  really  want  to  clear  all  configurations?     (yes,  y,  no, 

n) :    [no]  n 

switch : admin>  cfgsave 

You  are  about  to  save  the  Defined  zoning  configuration.  This 

action  will  only  save  the  changes  on  Defined  configuration. 

Any  changes  made  on  the  Effective  configuration  will  not 

take  effect  until  it  is  re-enabled. 

Do  you  want  to  save  Defined  zoning  configuration  only?  (yes, 

y,  no,  n) : 

[no]  n 
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cf gDisabl 
cf gEnable 
cf gSave 
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cfgCreate 

Creates  a  zone  configuration. 

Synopsis 


cfgcreate  "cfgName",   "member;  member" 


Availability 

admin 


[?2hf  NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  create  a  new  zone  configuration. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive:  for  example,  "Cfg_l  "  and  "cfg_l  "  are  different 
zone  configurations.  Blank  spaces  are  ignored. 

The  zone  configuration  member  list  must  have  at  least  one  member.  Empty  member  lists  are  not  allowed. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

See  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 
I^f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  required  operands: 

cfgName  Specify  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specify  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  create  a  configuration  containing  three  zones: 

switch : admin>  cfgcreate  "USA_cfg" ,    "Red_zone;   Blue_zone;  Green_zone" 
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See  also 

cfgAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
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cfg  Delete 

Deletes  a  zone  configuration. 

Synopsis 


cfgdelete  " cfgName" 


Availability 

admin 


[?2hf  NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  delete  a  zone  configuration. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  swi 

Operands 

This  command  has  the  following  operand: 

cfgName  Specify  a  name  for  the  zone  configuration  to  be  deleted,  in 

quotation  marks.  This  operand  is  required. 

Examples 

To  delete  a  zone  configuration: 

switch :admin>  cfgdelete  "USA_cfg" 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDisable 
cfgEnable 
cf gRemove 
cf gSave 
cf gShow 


tch. 
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cfgDisable 


Disables  a  zone  configuration. 


Synopsis 


cf gdisable 


Availability 


admin 


[2^>  NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
b— I    Services  and  bundled  with  each  B-series  switch. 


Use  this  command  to  disable  the  current  zone  configuration.  The  fabric  returns  to  nonzoning  mode,  in 
which  all  devices  see  each  other. 

This  command  ends  and  commits  the  current  zoning  transaction  buffer  to  both  volatile  and  flash  memory. 
If  a  transaction  is  open  on  a  different  switch  in  the  fabric  when  this  command  is  run,  the  transaction  on  the 
other  switch  is  automatically  aborted.  A  message  is  displayed  on  the  other  switches  to  indicate  the 
aborting  of  the  transaction. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Description 


Operands 


none 


Examples 


To  disable  the  current  zone  configuration: 


switch : admin>  cf gdisable 


You  are  about  to  disable  zoning  configuration.  This 


action  will  disable  any  previous  zoning  configuration  enabled. 


Do  you  want  to  disable  zoning  configuration?    (yes,  y,   no,   n) :    [no]  y 


See  also 


cf gClear 


cf gEnable 


cf gSave 
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cfg  Enable 

Enables  a  zone  configuration. 

Synopsis 

cfgenable " cfgName" 

Availability 

admin 


[?2hf  NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  enable  a  zone  configuration.  The  specified  zone  configuration  is  built  by  checking 
for  undefined  zone  names,  zone  alias  names,  or  other  inconsistencies  by  expanding  zone  aliases, 
removing  duplicate  entries,  and  then  installing  the  current  configuration. 

If  the  build  fails,  the  previous  state  is  preserved  (zoning  remains  disabled,  or  the  previous  configuration 
remains  in  effect).  If  the  build  succeeds,  the  new  configuration  replaces  the  previous  configuration.  See  the 
cf  gShow  command  for  a  description  of  defined  and  current  configurations. 


'^f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operand: 

cfgName  Specify  the  name  of  a  zone  configuration  to  enable,  in  quotation 

marks.  This  operand  is  required. 

Examples 

To  enable  the  zone  configuration  "USA_cfg": 


switch : admin>  cfgenable  "USA_cfg" 

You  are  about  to  enable  a  new  zoning  configuration. 

This  action  will  replace  the  old  zoning  configuration  with 

the 

current  configuration  selected. 

Do  you  want  to  enable   'USA_cfg'   configuration     (yes,   y,  no, 

n) :    [no]  y 

zone  config  "USA_cfg"   is  in  effect 

Updating  flash  . . . 

See  also 

cf gClear 
cf gDisable 
cf gSave 
cf gShow 
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cfg  Remove 

Removes  a  member  from  a  zone  configuration. 

Synopsis 

cfgremove  "cfgName",   "member  [;  member  ...]' 

Availability 

admin 


NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  zone  configuration. 
If  all  members  are  removed,  the  zone  configuration  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots,  it 
must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  in  effect,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

'2^>  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

The  following  operands  are  required: 

cfgName  Specify  a  name  for  the  zone  configuration,  in  quotation  marks. 

member  Specify  a  zone  member  or  list  of  zone  members  to  be  added  to 

the  configuration,  in  quotation  marks  and  separated  by 
semicolons.  Members  can  be  specified  in  one  or  more  of  the 
following  ways: 

•  Zone  names 

•  QuickLoop  names 

•  FA  (Fabric  Assist)  zone  names 

Examples 

To  remove  a  zone  from  a  configuration: 

switch : admin>  cfgremove  "Test_cfg" ,  "redzone" 

See  also 

cf gAdd 
cf gClear 
cf gCreate 


88     Fabric  OS  commands 


cf gDelete 

cf gDisable 

cf gEnable 

cf gSave 

cf gShow 

cf gTransAbort 

cf gTransShow 
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cfgSave 

Saves  zone  configuration  to  flash  memory. 

Synopsis 

cf gsave 

Availability 

admin 


NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  save  the  current  zone  configuration.  The  defined  configuration  and  the  name  of  the 
enabled  configuration  are  written  to  flash  memory  in  all  switches  in  the  fabric. 

The  saved  configuration  is  automatically  reloaded  by  the  switch  on  power  on  and,  if  a  configuration  was 
in  effect  at  the  time  it  was  saved,  the  same  configuration  is  reinstalled  with  an  automatic  cfgEnable 
command. 

Because  the  saved  configuration  is  reloaded  at  power  on,  only  valid  configurations  are  saved.  cfgSave 
verifies  that  the  enabled  configuration  is  valid  by  performing  the  same  tests  as  cfgEnable.  If  the  tests 
fail,  an  error  is  displayed  and  the  configuration  is  not  saved.  Tests  might  fail  if  a  configuration  has  been 
modified  since  the  last  cfgEnable. 

This  command  ends  and  commits  the  current  transaction.  If  a  transaction  is  open  on  a  different  switch  in 
the  fabric  when  this  command  is  run,  the  transaction  on  the  other  switch  is  automatically  aborted.  A 
message  is  displayed  on  the  other  switches  to  indicate  the  aborting  of  the  transaction. 


'^f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  save  a  zone  configuration: 


switch : admin>  cf gsave 

You  are  about  to  save  the  Defined 

zoning  configuration.  This 

action  will  only  save  the  changes 

on  Defined  configuration. 

Any  changes  made  on  the  Effective 

configuration  will  not 

take  effect  until  it  is  re-enabled. 

Do  you  want  to  save  Defined  zoning 

configuration  only?     (yes,  y,  no,  n)  : 

[no]  n 

Updating  flash  . . . 
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See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gShow 
cf gTransAbort 
cf gTransShow 
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cfgShow 


Displays  zone  configuration  information. 


Synopsis 

cfgshow   ["pattern"  ]  [,  mode] 

Availability 

all  users 


[2^>  NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 


If  no  operand  is  specified,  all  zone  configuration  information  (both  defined  and  effective)  appears.  If  the 
local  switch  has  an  outstanding  transaction,  this  command  displays  the  newly  edited  zone  configuration 
that  has  not  yet  been  saved.  If  the  local  switch  has  no  outstanding  transaction,  this  command  displays  the 
committed  zone  configuration. 

If  an  operand  is  specified,  it  is  used  as  a  pattern  to  match  zone  configuration  names  in  the  defined 
configuration;  those  that  match  the  pattern  appears. 

The  defined  configuration  is  the  complete  set  of  all  zone  objects  that  have  been  defined  in  the  fabric. 
There  can  be  multiple  zone  configurations  defined,  but  only  one  can  be  enabled  at  a  time.  There  might  be 
inconsistencies  in  the  definitions,  zones,  or  aliases  that  are  referenced  but  not  defined,  or  there  might  be 
duplicate  members.  The  defined  configuration  is  the  current  state  of  the  administrator  input. 

The  effective  configuration  is  the  single  zone  configuration  that  is  currently  enabled.  The  devices  that  an 
initiator  sees  in  the  fabric  are  based  on  this  configuration.  The  effective  configuration  is  built  when  a 
specific  zone  configuration  is  enabled  and  all  error  checking  has  been  completed  successfully. 

This  command  does  not  display  any  zoning  configuration  output  the  first  time  a  transaction  is  aborted  on 
a  local  switch.  Instead,  this  command  displays  the  following  warning: 

Warning:   Current  Zoning  Transaction  was  aborted. 

Reason  code  =  Zone  Config  update  received 

For  example,  suppose  a  transaction  is  created  on  SW1  using  the  cf  gCreate  or  zoneCreate 
commands.  From  another  switch,  SW2,  in  the  fabric,  execute  a  transaction-closing  command  such  as 
cfgDisable,  cfgEnable,  or  cfgSave.  This  sends  a  zone  configuration  update  to  all  switches  in  the 
fabric  and  the  open  transaction  on  SW1  is  aborted.  If  you  then  issue  a  cf  gShow  command  on  SW1 ,  only 
the  warning  is  displayed;  no  zoning  configuration  information  is  displayed. 


f2£b?  NOTE:   When  security  is  enabled,  this  command  can  be  issued  on  any  FCS  switch  in  the  fabric. 


Description 


Use  this  command  to  display  zone  configuration  information. 
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Operands 

This  command  has  the  following  optional  operands: 

pattern  A  POSIX-style  regular  expression  used  to  match  zone 

configuration  names.  The  pattern  must  be  enclosed  in  quotation 
marks,  and  can  contain: 

•  Question  mark  (?),  which  is  a  placeholder  for  any  single 
character 

•  Asterisk  (*),  which  is  a  placeholder  for  any  string  of 
characters 

•  Ranges,  which  are  a  placeholder  for  any  character  within  the 
range.  Ranges  must  be  enclosed  in  brackets:  for  example, 

[0-9]  or  [a-f]. 

mode  Specify  0  to  display  the  contents  of  the  transaction  buffer  (the 

contents  of  the  current  transaction)  or  specify  1  to  display  the 
contents  of  flash  memory.  The  default  value  is  0. 

Examples 

To  display  all  zone  configurations  that  start  with  "Test": 

switch : admin>  cfgshow  "Test*" 

cfg:       Testl  Blue_zone 

cfg:       Test_cfg  Red_zone;  Blue_zone 

To  display  all  zone  configuration  information: 

switch : admin>  cfgshow 
Defined  configuration: 

cfg:       USA1  Blue_zone 

cfg:       USA_cfg  Red_zone;  Blue 

zone:  Blue_zone 

1,1;  arrayl ;   1,2;  array2 

zone:  Red_zone 
1,0;  loopl 

alias:   arrayl  21:00:00:20:37 

alias:   array2  21:00:00:20:37 

alias:    loopl  21:00:00:20:37 

Effective  configuration: 
cfg:  USA_cfg 
zone:  Blue_zone 
1,1 

21:00:00:20:37:0c:76 
21:00:00:20:37:0c:71 
1,2 

21:00:00:20:37:0c:76 
21:00:00:20:37:0c:76 
zone:  Red_zone 
1,0 

21:00:00:20:37:0c:76 
21:00:00:20:37:0c:71 

To  display  only  configuration  names: 

switch : admin>  cfgshow  "*" 
cfg:       USA1  Blue_zone 
cfg:       USA_cfg  Red_zone;  Blue_zone 


:0c :76:8c;  21:00:00:20:37: 0c:71: 02 
:0c:76:22;  21:00:00:20:37: 0c:76:28 
:0c :76:85;    21:00:00:20:37: 0c:71:df 
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See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cfgTrans Abort 
cf gTransShow 
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cfgSize 

Displays  zone  database  size  details. 

Synopsis 

cfgsize  [integer] 

Availability 

all  users 


[?2hf  NOTE:  This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  display  the  size  details  of  the  zone  database.  All  sizes  are  in  bytes. 

The  size  details  include  the  following: 

Zone  DB  max  size  The  upper  limit  for  the  defined  configuration,  determined  by  the 

amount  of  flash  memory  available  for  storing  the  defined 
configuration. 

Transaction  size  The  size  of  the  uncommitted  defined  configuration.  This  value  will 

be  nonzero  if  the  defined  configuration  is  being  modified  by 
telnet,  API,  and  so  forth;  otherwise  it  is  0. 

Committed  size  The  size  of  the  defined  configuration  currently  stored  in  flash. 

See  cf  gShow  for  a  description  of  defined  and  effective  configurations. 


[2^>  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  optional  operand: 

integer  If  a  nonzero  integer  is  specified  as  the  parameter,  the  size  of  the 

flash  memory  allocated  for  the  zone  database  is  displayed.  The 
zone  database  includes  both  the  defined  and  effective 
configurations.  This  size  is  in  kilobytes. 

Examples 

To  display  size  details  of  the  defined  configuration: 

switch : admin>  cfgsize 

Zone  DB  max  size  -  127726  bytes 

committed  -  8812 

transaction  -  0 

switch : admin>  cfgsize  1 

Zone  DB  flash  size  -  131028  bytes 

See  also 
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cf gShow 
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cfgTrans  Abort 

Aborts  the  current  zoning  transaction. 

Synopsis 

cf gtransabort  [token] 

Availability 

admin 


r2^f  NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  abort  the  current  zoning  transaction  without  committing  it.  All  changes  made  since 
the  transaction  was  started  will  be  removed  and  the  zone  configuration  database  restored  to  the  state 
before  the  transaction  was  started. 

If  a  transaction  is  open  on  a  different  switch  in  the  fabric  when  this  command  is  run,  the  transaction  on  the 
other  switch  remains  open  and  unaffected. 

'^Jf  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operand: 

token  Specify  the  token  ID  of  an  abortable  transaction.  Use  the 

cfgTransShow  command  to  obtain  the  token  ID  of  a  transaction. 

Examples 

To  abort  the  current  transaction: 

switch : admin>  cf gtransabort 

See  also 

cfgAdd 
cf gClear 
cf gCreate 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 
cfgTransShow 
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cfgTransShow 

Displays  information  about  the  current  zoning  transaction. 

Synopsis 

cf gtransshow 

Availability 

all  users 


NOTE:   This  command  requires  HP  Advanced  Zoning,  which  is  included  within  the  Base  Configuration 
t— I    Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  display  the  ID  of  the  current  zoning  transaction.  This  command  also  gives  information 
about  whether  or  not  a  transaction  can  be  aborted  or  not.  The  transaction  cannot  be  aborted  if  it  is  an 
internal  zoning  transaction. 


\^}f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  display  the  current  transaction: 


switch : admin>  cf gtransshow 

There  is  no  outstanding  zone  transactions 

switch : admin>  cfgclear 

Do  you  really  want  to  clear  all  configurations?     (yes,  y,   no,  n) : 

[no]  y 

Clearing  All  zoning  configurations... 

switch : admin>  cf gtransshow 

Current  transaction  token  is  27101073  6 

It  is  abortable 

See  also 

cfgAdd 

cf gClear 

cf gCreate 

cf gDelete 

cf gDisable 

cf gEnable 

cf gRemove 

cf gSave 

cf gShow 

c  fgTrans Abort 
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chassisConfig 


Displays  or  sets  the  configuration  of  the  chassis. 

Synopsis 

chassisconf ig  [   -f  ]    [   option  ] 

Availability 

admin  (set) 

all  users  (display) 
Description 

Use  this  command  to  set  the  chassis  configuration  for  products  that  support  both  single-switch  and 
dual-switch  operation. Each  configuration  specifies  whether  the  chassis  runs  as  one  logical  switch  or  two. 
Each  configuration  also  specifies  the  port  blade  ID  that  is  permitted  on  each  logical  switch.  Any  port  blade 
ID  that  does  not  match  the  current  configuration  is  considered  incompatible,  and  does  not  power  up. 

When  no  arguments  are  provided,  this  command  displays  the  current  configuration  of  the  chassis  as  well 
as  a  list  of  the  supported  configurations.  When  a  specific  option  is  provided  to  this  command,  all  CPs 
currently  in  the  system  are  immediately  rebooted,  returning  in  the  mode  that  the  user  specified.  This  can 
result  in  some  blades  being  faulted  as  incompatible,  based  on  the  new  configuration  option.  This 
command  rejects  without  causing  a  reboot,  if  an  option  is  not  supported  by  the  platform.  See  the 
"Operands"  section  for  supported  options. 

Of  the  following  options,  HP  StorageWorks  SAN  Director  2/1  28  supports  options  1  through  4  and  HP 
StorageWorks  4/256  SAN  Directors  support  options  1  and  5: 

1.  One  128-port  switch  (blade  ID  4,  17  on  slots  1  through  4  and  7  through  10;  blade  ID  5,  16  on  slots 
5  and  6) 

2.  Two  64-port  switches  (blade  ID  4  on  slots  1  through  4  and  7  through  1 0;  blade  ID  5  on  slots  5  and  6) 

3.  Two  64-port  switches  (blade  ID  4  on  slots  1  through  4,  blade  ID  2  on  slots  7  through  1 0;  blade  ID  5 
on  slots  5  and  6) 

4.  Two  64-port  switches  (blade  ID  2  on  slots  1  through  4,  blade  ID  4  on  slots  7  through  1 0;  blade  ID  5 
on  slots  5  and  6) 

5.  One  256-port  switch  (blade  ID  1 7,  1  8  on  slots  1  through  4  and  7  through  1 0;  blade  ID  1 6  on  slots  5 
and  6) 

Use  the  slotShow  command  to  display  the  current  set  of  blades  in  the  system. 

When  the  system  changes  from  single  to  multiple  domains  and  vice  versa,  configuration  parameters  that 
are  not  compatible  are  restored  to  factory  defaults.  The  configuration  data  includes,  but  not  limited  to 
routing,  port  swap,  fabric,  zoning,  port  configuration,  passwords,  security,  HP  Fabric  Watch,  management 
server,  time  server,  SNMP,  performance  monitoring,  and  general  HP  Fabric  OS  configuration  values.  It  is 
recommended  that  the  current  configuration  be  saved  using  conf  igUpload  as  a  guide  for  adjustments 
after  the  configuration  change. 

Certain  configuration  values  that  are  not  considered  switch  based  and  determined  not  to  cause  adverse 
effects  are  left  untouched  for  user  convenience.  These  include  SSL  certificates,  PKI  certificates,  licenses,  and 
IP  address. 

When  the  -f  (force)  option  is  omitted,  this  command  prompts  for  user  consent  to  proceed  further  with  the 
configuration  change.  It  also  prompts  the  user  to  upload  the  configuration  data  to  a  host  so  it  can  be  used 
as  a  guide  to  re-establishing  the  configuration  data  in  the  new  mode.  Use  the  -f  option  to  proceed 
without  the  interactive  step. 
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Unless  the  chassis  is  currently  configured  as  Option  1  (a  single  1  28-port  switch  with  blade  IDs  4  and  1 7 
and  CP  blade  IDs  5  and  1 6),  both  CP  blades  should  always  contain  firmware  that  supports  this 
command.  Use  of  earlier  versions  will  adversely  affect  switch  operation. 

Because  this  is  a  disruptive  operation  and  has  profound  effect  on  the  behavior  of  the  chassis,  it  needs  to 
be  used  selectively. 

Users  running  secure  mode  should  be  particularly  careful  in  using  this  command  to  change  the  number  of 
domains  on  the  local  chassis,  because  security  is  disabled  on  all  resulting  local  switches.  These  switches 
are  not  able  to  participate  in  a  secure  fabric  until  secure  mode  is  restored.  Therefore,  the  fabric  should 
have  a  primary  FCS  outside  this  chassis,  to  manage  security  throughout  the  fabric  during  this  transition. 

Operands 

The  operands  are  as  follows: 

-f  If  specified,  forces  configuration  changes  without  asking  for  confirmation  or 

requesting  a  configuration  upload. 

option  Specifies  the  new  configuration  option  to  apply  to  the  chassis.  This  operand  is 

optional;  if  omitted,  this  command  displays  the  current  configuration  option 
and  a  list  of  all  valid  options.  Values  include: 

1  One  1  28-port  switch  (blade  ID  4,  17  on  slots  1  through  4  and  7 
through  10;  blade  ID  5,  16  on  slots  5  and  6) 

2  Two  64-port  switches  (blade  ID  4  on  slots  1  through  4  and  7  through 
10;  blade  ID  5  on  slots  5  and  6) 

3  Two  64-port  switches  (blade  ID  4  on  slots  1  through  4,  blade  ID  2  on 
slots  7  through  1 0;  blade  ID  5  on  slots  5  and  6) 

4  Two  64-port  switches  (blade  ID  2  on  slots  1  through  4,  blade  ID  4  on 
slots  7  through  1 0;  blade  ID  5  on  slots  5  and  6) 

5  One  256-port  switch  (blade  ID  1 7,  1 8  on  slots  1  through  4  and  7 
through  1 0;  blade  ID  1 6  on  slots  5  and  6) 

Examples 

To  display  the  current  configuration  option  on  an  HP  StorageWorks  SAN  Director  2/1  28  and  to  change 
the  option: 
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switch : admin>  chassisconf ig 
Current  Option:  1 

All  Supported  Options    (With  Blade  ID  5  on  slots  5-6) 


Option  1:  One  128-port  switch 

(Blade  ID  4,    17  on  slots  1-4,    7-10,   Blade  ID  5,    16  on  slots  5-6) 
Option  2:  Two  64-port  switches 

(Blade  ID  4  on  slots  1-4,   7-10,   Blade  ID  5  on  slots  5-6) 
Option  3:  Two  64-port  switches 

(Blade  ID  4  on  slots  1-4,   ID  2  on  slots  7-10,   Blade  ID  5  on  slots  5-6) 
Option  4:  Two  64-port  switches 

(Blade  ID  2  on  slots  1-4,    ID  4  on  slots  7-10,   Blade  ID  5  on  slots  5-6) 

Please  use  slotshow  to  see  the  Blade  IDs  of  the  SW  and  CP  blades  and 
check  with 

customer  support  on  the  list  of  all  available  SW  and  CP  Blade  IDs  and 
their 

marketing  names . 

switch : admin>  chassisconf ig  2 

This  will  reboot  all  the  CPs  and  the  configuration  data  will  be  restored 
to 

factory  defaults  if  moved  between  single  and  multiple  domains.  This 
includes , 

but  are  not  limited  to,   port  swap,   routing,    zoning,  performance 
monitoring,  port 

config,    fabric  watch,  management  server,   time  server,   snmp,  security, 
fabric  and 

other  FabOs  configuration  parameters . 

Traffic  will  be  disrupted  and  both  the  CPs  comes  up  and  will  vary  in  the 
number 

of  switches  and  the  Blade  IDs  they  recognize  based  on  the  configuration 

selected.  Some  configuration  values  are  applicable  to  both  single-domain 
and 

multiple-domain  switches,   and  are  therefore  not  modified.  (Examples: 
licenses , 

IP  addresses,  host  and  switch  names,   SSL  certificates,  PKI 
certificates.)  Please 

read  the  man  page  for  further  information, 
(continued  on  next  page) 
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See  also 


Please  upload  switch  0  configuration... 

Server  Name  or  IP  Address   [host]:  192.168.79.240 

User  Name   [user] :  ckonchad 

File  Name   [config.txt] : 

Password: 

Upload  complete 

Are  you  sure  you  want  to  continue?    (Y/N) :  y 

Current  Option  changed  to  2 

Restoring  switch  0  configuration  to  factory  defaults.. 

.  done . 

(Telnet  connection  goes  down  at  this  point.) 

conf igDownload 

conf igUpload 

slotShow 
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chassisName 


Displays  or  sets  the  chassis  name  for  a  switch. 

Synopsis 

chassisname  [name] 

Availability 

admin  (set) 

all  users  (display) 
Description 

Use  this  command  to  change  the  name  associated  with  the  chassis.  In  the  HP  StorageWorks  Core  Switch 
2/64  and  HP  StorageWorks  SAN  Director  2/1  28,  there  are  two  logical  switches  associated  with  a  single 
chassis. 

Enter  this  command  with  no  parameter  to  display  the  current  name. 
Enter  this  command  with  a  name  operand  to  set  the  chassis  name. 

Operands 

This  command  has  the  following  operand: 

name  Specifies  a  new  name  for  the  chassis.  Chassis  names  can  be  up  to  15  characters 

long  and  must  begin  with  a  letter.  The  name  must  consist  of  letters,  digits,  or 
underscore  characters  and  no  spaces. 


Examples 

To  change  the  chassis  name  to  "dilbert": 


switch : admin>  chassisname  dilbert 

Please  wait  while  committing  configuration. . . 

switch : admin>  chassisname 

dilbert 


See  also 

switchName 
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chassisShow 

Displays  all  field  replaceable  units  (FRUs). 

Synopsis 

chassisshow 

Availability 

all  users 

Description 

Use  this  command  to  inventory  and  display  the  FRU  header  content  for  each  object  in  the  chassis  and 
chassis  backplane  version. 

The  header  data  is  formatted  into  a  record  consisting  of  up  to  13  lines.  See  Table  4  for  more  information 
about  the  lines  and  their  meaning. 


Table  4   Command  output  descriptions 


Line 

liQcrnnfiAn 

L/ebcnpTiun 

i 

If  applicable,  the  first  line  displays  the  chassis  backplane  version  number,  in  hexadecimal. 

2 

Object  type:  CHASSIS,  fan,   power  supply,  SW  blade  (switch),  CP  blade  (control 
processor),  wwn  (world  wide  name),  or  unknown. 

Object  number:  Slot  nn  (for  blades),  Unit  nn  (for  everything  else). 

If  the  FRU  is  part  of  an  assembly,  a  brief  description,  in  parentheses,  displays. 

3 

FRU  header  version  number:  Header  Version:  x 

4 

Value  to  calculate  the  object's  power  consumption:  positive  for  power  supplies  and  negative 
for  power  consumers.  Power  Consume  Factor:  -xxx 

5 

Part  number  (up  to  14  characters):  Factory  Part  Num:  xx-xxxxxx-xx 

6 

Serial  number  (up  to  1  2  characters):  Factory  Serial  Num:  xxxxxxxxxx 

7 

FRU  manufacture  date:  Manufacture :  Day:  dd  Month:  mm  Year:  yyyy 

8 

Date  of  the  last  FRU  header  update:  Update  :  Day:  dd  Month:  mm  Year:  yyyy 

9 

Cumulative  time,  in  days,  that  the  FRU  has  been  powered  on:  Time  Alive  :dddd  days 

10 

Current  time,  in  days,  since  the  FRU  was  last  powered  on:  Time  Awake  :ddd  days 

11 

Externally  supplied  ID  (up  to  1  0  characters):  ID:  xxxxxxxxxx 

12 

Externally  supplied  part  number  (up  to  20  characters): 

Part  Num:  xxxxxxxxxxxxxxxxxxxx 

13 

Externally  supplied  serial  number  (up  to  20  characters): 

Serial  Num: xxxxxxxxxxxxxxxxxxxx 

f^)f  NOTE:    On  some  platforms,  for  certain  FRU  types,  a  few  items  might  be  unavailable.  In  these  cases,  the 
lines  are  suppressed.  Possibly  affected  lines  are  1,  3  through  7,  9,  and  1 1  through  14.  In  addition,  for 
lines  1 1  through  14,  if  there  is  no  data  set,  these  lines  are  suppressed. 


Operands 

none 
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Examples 

To  display  all  FRUs  for  a  switch: 
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switch :user>  chassisshow 

Chassis  Backplane  Revision:  1C 

SW  BLADE      Slot:  3 

Header  Version: 

1 

Power  Consume  Factor: 

-180 

Factory  Part  Num: 

60-0001532-03 

Factory  Serial  Num: 

1013456800 

Manufacture : 

Day:   12  Month: 

D 

Year : 

9  n  n  1 

Update : 

Day:   15  Month: 

n 
l 

Year : 

9  n  n  1 

Time  Alive: 

2  8  days 

Time  Awake : 

1 6  days 

ID: 

555-374757 

Part  Num: 

234-294-12345 

Serial  Num: 

2734658 

Revision  Num: 

A. 00 

CP  BLADE      Slot:  6 

Header  Version: 

1 

Power  Consume  Factor: 

-40 

Factory  Part  Num: 

60-0001604-02 

Factory  Serial  Num: 

FP00X600128 

Manufacture : 

Day:   12  Month: 

c 
D 

Year : 

9  n  n  1 

Update : 

Day:   15  Month: 

n 
l 

Year : 

9  n  n  1 

Time  Alive: 

6 1  days 

Time  Awake : 

1 6  days 

ID: 

555-374757 

Part  Num: 

236-296-12350 

Serial  Num: 

2836542 

Revision  Num: 

A. 00 

POWER  SUPPLY     Unit:  2 

Header  Version: 

1 

Power  Consume  Factor: 

1000 

Factory  Part  Num: 

60-0001536-02 

Factory  Serial  Num: 

A013450700 

Manufacture : 

Day:   14  Month: 

D 

Year : 

9  n  n  1 

Update : 

Day:   15  Month: 

7 

Year : 

9  n  n  1 

Time  Alive: 

5  0  days 

Time  Awake : 

1 6  days 

ID: 

555-374757 

Part  Num: 

238-298-12360 

Serial  Num: 

1234567 

(continued  on  next  page) 
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TTATST        TTt-i  -i  -1-  •  1 

T-T^  ^             V"      T  7"^  V"  O  n  • 

rlt;clU.t=X     Vclol  Oil  . 

1 

ratLUly    Jr  a.  Jl  L    1M  LULL . 

90-1 9^AR^-1 9 
ZU    1Z  j^l  JD  _lz 

ratLUiy     ofci-L-Lci-l-    In  UIIL . 

jjdy .      0  I'lcjiiuii. 

/        I  fcid.1  . 

9  n  n  1 

uay  .    -L  d     iviomzii . 

7     Year : 

9  n  n  1 

Tims  Alive: 

0  0  aays 

Time  Awake : 

1 6  days 

ID: 

456-777888 

Part  Num: 

230-290-12370 

(output  truncated) 

See  also 

slotShow 
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chipRegShow 


Displays  the  port  registers  for  a  given  chip  number. 


Synopsis 

chipregshow   [ slotnumber/ ] chipnumber  [filter] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  ASIC  pair  register  contents  for  the  specified  chip  on  the  specified  blade 
slot. 


ptyf  NOTE:    The  output  of  this  command  is  only  for  support  use  only. 


Operands 


This  command  has  the  following  operands: 


filter 


[slotnumber/] chipnumber 


Specifies  the  index  of  the  chip  within  the  specified  blade  to 
display.  The  default  is  set  to  0  and  designed  to  operate  on 
fixed-port-count  products. 

Specifies  a  filter  string. 


Examples 


To  display  the  port  registers  of  a  chip: 


switch : admin>  chipregshow  1/1  ffffffff 


See  also 


minisPropShow 
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cmemRetentionTest 


Tests  the  data  retention  of  the  central  memory  SRAMs. 


Synopsis 

cmemretentiontest   [--slot  slotnumber]  [-passcnt  count] [-datatype 
type] [-ports  itemlist]  [-seed  value] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  data  written  into  the  central  memory  SRAMs  in  the  ASIC  pair  is  retained 
after  a  1 0-second  wait.  The  method  used  is  to  write  a  fill-pattern  to  all  SRAMs,  wait  1 0  seconds,  and  then 
read  all  SRAMs  to  verify  that  the  data  read  matches  the  data  previously  written.  The  process  is  then 
repeated  using  the  reverse  version  of  the  pattern. 


[—)f  NOTE:  This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using 
the  switchDisable  command.  This  command  is  not  supported  on  the  4/16  SAN  Switch,  SAN  Switch 
4/32  and  4/256  SAN  Director,  which  use  the  Condor  ASIC. 


Operands 


This  command  has  the  following  operands: 


--slot 
slotnumber 


-passcnt 
count 

-datatype 
type 


-ports 
i  temlist 

-seed 
value 


Specify  the  slot  number  on  which  the  diagnostic  will  operate.  The  ports  specified  will 
be  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed  to  operate  on 
fixed-port-count  products. 

Specify  the  number  of  test  passes  to  run.  By  default,  the  test  will  be  run  one  time. 

Specify  the  type  of  data  pattern  to  use.  By  default,  type  9,  QUAD_RAMP,  is  used.  For 
a  complete  list  of  supported  data  patterns,  run  the  dataTypeShow  command.  Some 
common  settings  are: 


Pattern  Type  Example 

BYTE  FILL  1  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00  00 

WORD_FILL  2  0000  0000  0000  0000  0000  0000  0000  0000 

QUAD_FILL  3  00000000     00000000     00000000  00000000 

QUAD_RAMP  9  00000000     00000001     00000002  00000003 

RANDOM  11  55  16fcd7  17  65  a9  87  5f  44  be  5a  dO  de  be  a5 

Specifies  a  list  of  blade  ports  to  test.  The  ports  list  is  translated  into  a  matching  quad 
list  before  the  test  is  run.  By  default,  all  the  blade  ports  in  the  specified  slot  (-slot)  are 
tested.  See  the  itemList  help  pages  for  further  details. 

Specify  the  data  pattern  seed  to  be  used.  The  default  seed  value  is  0. 
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Examples 

To  run  the  data-retention  test  on  the  central  memory  SRAMS: 

switch : admin>  cmemretentiontest  --slot  3 

Running  cmemretentiontest   

Test  Complete:  cmemretentiontest  Pass  2  of  2 

Duration  0  hr,   2  min  Duration  0  hr,   2  min  Duration  0  hr,   2  min  &  13  sec 
(0:2:13:234).    13   sec    (0:2:13:234).    13   sec  (0:2:13:234). 

passed. 

Diagnostics 

The  following  are  possible  error  messages: 

LCMEM_ERR 
LCMRS_ERR 
LCMTO_ERR 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

camTest 

centralMemoryTest 

cmiTest 

crossPortTest 

dataTypeShow 

itemList 

portLoopbackTest 
spinSilk 

sraraRetentionTest 
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cmiTest 

Verifies  the  control  message  interface  (CMI)  bus  between  ASICs. 

Synopsis 

cmitest   [--slot  slotnumber]  [-passcnt  count] [-txports  itemlist]  [-rxports 
itemlist]  [-skip  mask] 

Availability 

admin 

Description 

Use  this  command  to  test: 

•  Multiplexed  4-bit  CMI  point-to-point  connection  between  two  ASICs. 

•  Message  sent  with  a  bad  checksum  sets  the  error  and  interrupt  bits  of  the  destination  ASIC. 

•  Message  sent  with  a  good  checksum  does  not  set  any  error  or  interrupt  bit  in  any  ASIC  pair. 

The  CMI  is  used  to  send  transmission  requests  or  completion  messages  between  the  ASIC  transmitter  and 
receiver. 

[2^?  NOTE:   This  command  is  not  supported  on  the  4/16  SAN  Switch,  SAN  Switch  4/32  and  4/256  SAN 
Director,  which  use  the  Condor  ASIC. 


Options 

This  command  has  the  following  options: 

--slot  slotnumber      Specifies  the  slot  number  to  test.  The  default  is  set  to  0  and  designed 

to  operate  on  fixed-port-count  products. 

-passcnt  count  Specifies  the  number  of  test  passes  to  run.  By  default,  the  test  runs  one 

time. 

-txports  itemlist      Specifies  a  list  of  ports  to  transmit  data.  By  default,  all  the  ports  in  the 

specified  slot  (--slot)  are  used.  See  itemList  help  pages  for  further 
details. 

-rxports  itemlist      Specifies  a  list  of  ports  to  receive  data.  By  default,  all  the  ports  in  the 

specified  slot  (--slot)  are  used.  See  itemList  for  more  information. 

-skip  mask  Specifies  tests  to  skip  using  a  bit  map  as  follows: 

1  CMI  data  test  (ignore  checksum) 

2  CMI  checksum  test 

3  Enable  all  tests 
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Examples 

To  run  a  CMI  test  between  two  ASIC  pairs: 


switch : admin>  cmitest  - 

-txports  3/0-3/7  -rxports  3/8-3/15 

Running  cmitest   

Test  Complete:  cmitest 

Pass  1  of  1 

Duration  0  hr,    0  min  & 

2  sec    (0:0:2:591)  . 

passed. 

Diagnostics 

Listed  below  are  possible  error  messages  if  failures  are  detected: 

DIAG-BADINT 

DIAG-CMICKSUM 

DIAG-CMIDATA 

DIAG-CMIINVCAP 

DIAG-CMINOCAP 

DIAG-CMISAl 

DIAG-INTNIL 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

camTest 

centralMeraoryTest 
cmemRecentionTesc 
cross PortTest 
itemList 

portLoopbackTest 
spinSilk 

sramRetentionTest 
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config  Default 


Restores  the  system  configuration  to  default. 


Synopsis 


configde fault 


Availability 


admin 


Description 


Use  this  command  to  reset  a  subset  of  configuration  settings  to  the  default  values. 
All  configuration  parameters,  with  the  following  exceptions,  are  reset: 


Ethernet  MAC  address,  IP  address,  and  subnetmask 


IP  gateway  address 
License  keys 


•  OEM  customization 

•  Product  ID  and  vendor  ID 

•  SNMP  configuration 

•  System  name 

•  world  wide  name 

•  HP  Advanced  Zoning  configuration 

•  Security  parameters  and  policies 

•  User  account  passwords 

•  Switch  PID  format 

•  Ethernet  link  mode 

Some  configuration  parameters  are  cached  by  the  system.  To  avoid  unexpected  switch  behavior,  reboot 
the  system  after  executing  this  command. 

NOTE:    See  the  configure  command  for  more  information  on  default  values  for  configuration 


This  command  cannot  be  executed  on  an  enabled  switch.  You  must  first  disable  the  switch  using  the 

switchDisable  command. 


parameters. 


Some  configuration  parameters  are  cached  by  the  system.  To  avoid  unexpected  system  behavior,  reboot 
the  system  after  exciting  this  command. 


Operands 


none 
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Examples 

To  restore  the  system  configuration  to  default  values: 


switch : admin>  conf igdef ault 
Committing  Configuration  ...done. 


See  also 

agtCfgDefault 
configure 
switchDi sable 
switchEnable 
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config  Down  load 


Downloads  a  switch  configuration  file  from  a  host  file. 

Synopsis 

conf  igdownload   [ -p  ftp]   "host" ,"  user" ,"  file"  ,"passwd" 
conf  igdownload  -p  scp  " host" ," user"  ,"  file" 
conf igdownload 

Availability 

admin 


"2^>  NOTE:    The  switchAdmin  role  is  not  allowed  to  change  the  zoning  and  security  configuration.  Therefore, 
zoning  and  security  sections  in  the  configuration  being  downloaded  to  the  switch  are  ignored.  See 
"MUA-based  roles"  on  page  777  for  more  information. 


Description 

Use  this  command  to  download  a  switch  configuration  file  from  a  host  file.  The  configuration  file  is  ASCII 
text  and  might  have  been  generated  using  conf  igUpload,  or  it  might  have  been  created  by  a  user  to 
download  specific  configuration  changes.  See  conf  igUpload  for  a  configuration  file  format  description. 

To  restore  the  configuration  file  from  a  Microsoft®  Windows  NT®  system  using  file  transfer  protocol  (FTP), 
the  FTP  server  might  have  to  be  installed  from  the  distribution  media  and  enabled.  The  FTP  service  is 
widely  available  on  UNIX®  hosts  but  less  so  on  Windows®  hosts.  The  FTP  server  must  be  running  before  a 
download  can  occur. 

Use  -p  scp  to  securely  download  the  file  through  an  SSH  connection.  Instead  of  entering  a  password  on 
the  command  line,  SCP  prompts  you  for  the  password,  if  necessary.  The  SSH  service  is  available  on  both 
UNIX  and  Windows  hosts. 

This  command  can  be  invoked  without  any  operands,  creating  an  interactive  session. 
The  download  might  fail  for  the  following  reasons: 
The  switch  has  not  been  disabled. 

•  The  host  name  is  not  known  to  the  switch. 

•  The  host  IP  address  cannot  be  contacted. 

•  The  user  does  not  have  permission  on  the  host. 
The  user  runs  a  script  that  prints  something  at  login. 
The  file  does  not  exist  on  the  host. 

•  The  file  is  not  a  switch  configuration  file. 

•  The  FTP  server  is  not  running  on  the  host. 
The  configuration  data  contains  errors. 

When  the  switch  is  in  secure  mode,  the  following  rules  and  restrictions  apply: 

•  Both  defined  security  policies  and  active  security  policies  sections  must  exist  and  contain  the 
FCS_POLICY. 
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In  the  defined  security  policies  section,  at  least  one  member  of  the  FCS_POLICY  must  be  the  same  as  a 
member  in  the  previous  FCS_POLICY. 

•  In  the  active  security  policy  section,  the  FCS_POLICY  must  be  exactly  the  same  as  the  previous 
FCS_POLICY.  Order  of  members  must  be  maintained. 

•  If  either  security  policies  section  has  a  RSNMP  POLICY,  then  that  section  must  have  a 
WSNMP_POLICY. 

•  After  the  switch  is  enabled,  if  the  switch  is  the  primary  FCS,  then  its  security  and  zoning  information 
will  be  propagated  to  all  other  switches  in  the  fabric. 

•  After  the  switch  is  enabled,  if  the  switch  is  a  non-FCS  or  a  backup  FCS,  then  its  security  and  zoning 
information  will  be  overwritten  by  the  primary  FCS. 


ptyf  NOTE:   A  license  key  is  only  accepted  if  the  boot.mac  line  matches  the  world  wide  name  of  the  switch 


performing  the  download;  otherwise,  it  is  ignored. 

Security  parameters  and  the  switch's  identity  cannot  be  changed  by  conf  igDownload.  Parameters  such 
as  the  switch  name  and  IP  address  are  ignored;  they  are  lines  in  the  configuration  file  that  begin  with 
"boot".  Security  parameters  such  as  secure  mode  setting  and  version  stamp  are  ignored;  they  are  the  lines 
in  the  configuration  file  that  begin  with  "sec". 

conf  igDownload  does  not  enable  security  mode,  even  if  the  configuration  file  is  saved  in  security  mode. 

After  conf  igDownload,  the  policy  might  require  up  to  8  minutes  to  download. 

The  download  process  is  additive;  that  is,  the  lines  read  from  the  file  are  added  to  the  current  switch 
configuration.  This  enables  you  to  change  a  single  configuration  variable  by  downloading  a  file  with  a 
single  line.  All  other  variables  remain  unchanged. 


The  R_A_TOV,  E_D_TOV,  WAN_TOV,  and  MAX_HOPS  configuration  parameters  are  interrelated. 
Assigning  a  specific  value  to  one  or  more  of  these  parameters  might  change  the  range  of  allowed  values 
that  can  be  assigned  to  the  other  parameters.  As  a  result,  the  user  might  not  be  able  to  set  all  the  values 
within  the  range  displayed  against  each  parameter.  This  utility  validates  the  modified  values  of  these  four 
parameters  and  terminates  the  download  operation,  if  the  validation  check  fails. 

This  is  particularly  important  when  downloading  a  zoning  configuration.  Since  the  new  zoning 
information  is  added  to  the  current  configuration,  there  might  not  be  any  conflicts.  If  the  current  zoning 
configuration  is  to  be  replaced,  the  keyword  "clear:"  might  be  inserted  into  the  configuration  file 
immediately  before  the  zoning  lines  (starting  from  the  line  "[Zoning]"). 

If  the  configuration  file  contains  the  keyword  "enable:  <zone_configuration>",  then  that  zoning 
configuration  enables  in  the  fabric.  If  there  is  no  "enable:"  keyword  in  the  configuration  file  or  no  zoning 
configuration  by  that  name  exists,  or  if  enable  fails  for  any  reason  (such  as  dangling  aliases),  then: 

The  effective  configuration  remains  as  it  was  prior  to  conf  igDownload;  that  is,  all  the  "enable:" 
information  is  discarded. 

The  defined  configuration  changes  to  reflect  new  zoning  configuration. 


Operands 


This  command  has  the  following  optional  operands: 


-p 


Specifies  the  use  of  the  FTP  or  SCP  protocol.  If  a  protocol  is  not  specified, 
FTP  is  the  default. 
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host  Specifies  a  host  name  or  IP  address  in  quotation  marks:  for  example, 

"citadel"  or  "192.168.1.48".  The  configuration  file  is  downloaded  from 
this  host. 

user  Specifies  the  user  name,  in  quotation  marks:  for  example,  "jdoe".  This  user 

name  is  used  to  gain  access  to  the  host  system. 

file  Specifies  the  file  name,  in  quotation  marks:  for  example,  "conf  ig.  txt". 

Absolute  path  names  might  be  specified  using  a  forward  slash  (/).  Relative 
path  names  search  for  the  file  in  the  user's  home  directory  on  UNIX  hosts 
and  in  the  directory  on  which  the  FTP  server  is  running  on  Windows  hosts. 

passwd  Specifies  the  password  for  the  FTP  login. 

Examples 

To  download  a  configuration  file  using  FTP  from  host  "citadel",  using  account  "jdoe",  and  file 
conf ig . txt  : 

switch : admin>  conf igdownload  -p  ftp 
"citadel " ,  "jdoe" , " conf ig . txt " , "passwd" 

Committing  conf iguration ...  done . 

download  complete 

To  download  the  same  configuration  file  using  SCP: 

switch : admin>  conf igDownload  -p  scp  " citadel "," jdoe "," conf ig . txt " 
jdoe@citadel ' s  password:  ******** 
Committing  conf iguration ...  done . 
download  complete 


See  also 

conf igDe fault 
conf igShow 
conf igUpload 
configure 
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configShow 

Displays  system  configuration  settings. 

Synopsis 

configshow  ["filter"] 

Availability 

all  users 

Description 

Use  this  command  to  view  the  system  configuration  settings  set  by  the  configure  command. 

Operands 

This  command  has  the  following  optional  operand: 

filter  Specify  a  text  string,  in  quotation  marks,  that  limits  the  output  of 

the  command  to  only  those  entries  that  contain  the  text  string. 

Examples 

To  display  system  configuration  settings: 


NOTE:    Not  all  values  displayed  are  applicable  to  all  system  models  and  configurations. 


switch 

admin>  configshow 

diag.postDisable:  0 

fabric 

domain:  1 

fabric 

ops 

BBCredit:  16 

fabric 

ops 

E_D_TOV :            2  00  0 

fabric 

ops 

R_A_TOV:  10000 

fabric 

ops 

dataFieldSize : 

2112 

fabric 

ops 

max_hops :  7 

fabric 

ops 

mode . f cpProbeDisable 

0 

fabric 

ops 

mode . isolate : 

0 

fabric 

ops 

mode . pidFormat : 1 

fabric 

ops 

mode . tachyonCompat : 

0 

fabric 

ops 

mode . unicas  tOnly : 

0 

fabric 

ops 

mode .useCsCtl : 

0 

fabric 

ops 

vc. class. 2:  2 

fabric 

ops 

vc . class . 3 :  3 

fabric 

ops 

vc.config:  OxcO 

(continued 

on  next  page) 
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switch : admin>  configshow 

diag.postDisable : 

0 

fabric . domain :  1 

fabric . ops . vc . linkCtrl : 

0 

fabric . ops . vc .multicast : 

7 

fabric  .  ops  .  wan_tov : 

0 

f  c4  .  f  dp .  address  : 

192 . 168 . 65 . 62 

f  c4  .  f  dp  .mask :  255.255. 

255  .  0 

f cAL . f anFrameDisable : 

0 

f cAL . useAltBBCredit : 

0 

IcdContrast:         12  8 

licenseKey:  none 

rpc.rstatd:  1 

rpc.rusersd:  1 

See  also 

agtCf gShow 

configure 

diagDisablePost 

diagEnablePost 

ipAddrShow 

licenseShow 

syslogdlpShow 
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config  Upload 


Uploads  the  switch  configuration  file  to  a  host  file. 


Synopsis 


configupload   [ -p  ftp   |    scp] [host ,  user ,  file[ , passwd] ] 


Availability 

admin 

Description 

Use  this  command  to  upload  the  switch  configuration  to  a  host  file. 

To  upload  the  configuration  file  from  a  Microsoft  Windows  NT  system  using  file  transfer  protocol  (FTP),  the 
FTP  server  might  have  to  be  installed  from  the  distribution  media  and  enabled.  The  FTP  service  is  widely 
available  on  UNIX  hosts  but  less  so  on  Windows  hosts.  The  FTP  server  must  be  running  before  a  download 
can  occur. 

Use  -p  scp  to  securely  upload  the  file  through  an  SSH  connection.  Instead  of  entering  a  password  on  the 
command  line,  SCP  prompts  you  for  the  password,  if  necessary.  The  SSH  service  is  available  on  both 
UNIX  and  Windows  hosts. 

If  the  command  is  entered  without  operands,  it  becomes  interactive  and  prompts  the  user  for  input. 
The  upload  might  fail  for  the  following  reasons: 
The  host  name  is  not  known  to  the  switch. 
The  host  IP  address  cannot  be  contacted. 
The  user  does  not  have  permission  on  the  host. 
The  user  runs  a  script  that  prints  something  at  login. 
The  FTP  server  is  not  running  on  the  host. 
There  are  three  types  of  lines  in  the  configuration  file: 

License  keys  are  encrypted  ASCII  strings  and  are  listed  one  key  per  line. 

Comments  have  a  bracket  (  [  )  as  the  first  character  of  the  line.  (When  read  by  conf  igDownload,  a 
line  beginning  with  any  punctuation  is  treated  as  a  comment.) 

Name:value  pairs  have  the  following  syntax: 


line 

name 

space 

component 

value 


name  :  value 
component  {"."  component} 
{"  "  |  t"} 

u_n  I  //a"    ii -j ii  I  ii r\n    iidii  \  a   a  \  a  a 


|"q"  "z"  J  "A"        |  "0"  "9" 
{<any  character  not  including  n">} 


■"} 


f-ty?  NOTE:    Elements  enclosed  in  curly  braces  (  {...}  )  indicate  zero  or  more  occurrences  of  the  enclosed 
elements. 
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The  configuration  file  is  written  as  three  sections.  The  first  section  contains  the  switch  boot  parameters.  It 
has  variables  such  as  the  switch's  name  and  IP  address.  This  section  corresponds  to  the  first  few  lines  of 
output  of  the  conf  igShow  command. 

The  second  section  contains  general  switch  configuration  variables,  such  as  diagnostic  settings,  fabric 
configuration  settings,  and  SNMP  settings.  This  section  corresponds  to  the  output  of  the  conf  igShow 
command  (after  the  first  few  lines),  although  there  are  more  lines  uploaded  than  shown  by  the  command. 

The  third  sections  contains  zoning  configuration  parameters. 


NOTE:    In  Fabric  OS  5.x,  no  spaces  are  allowed  between  operands.  None  of  the  operands  use  quotation 
b_ I  marks. 


Operands 

This  command  has  the  following  optional  operands: 

host  Specify  a  host  name  or  IP  address,  in  quotation  marks:  for  example,  "citadel"  or 

"192  .168.1.48".  The  configuration  file  is  downloaded  from  this  host  system. 

user  Specify  a  user  name  in  quotation  marks:  for  example,  "jdoe".  This  user  name  is 

used  to  gain  access  to  the  host. 

file  Specify  a  file  name  in  quotation  marks;  for  example:  "conf  ig.  txt".  Absolute 

path  names  might  be  specified  using  forward  slash  (/).  Relative  path  names  create 
the  file  in  the  user's  home  directory  on  UNIX  hosts  and  in  the  directory  where  the 
FTP  server  is  running  on  Windows  hosts. 

passwd  Specify  a  password,  in  quotation  marks. 

Examples 

To  upload  a  configuration  file  using  FTP  to  host  "citadel",  using  account  "jdoe",  and  file 
conf ig . txt  : 


switch: 

:admin>  configupload  "citadel", 

, " j doe " , 

. " conf ig . txt " 

, "passwd" 

upload 

complete 

To  upload  the  same  configuration  file  using  SCP: 


switch :admin>  configupload  -p  scp  " citadel "," j doe "," conf ig . txt ' 
jdoe@citadel ' s  password:  ******** 


upload  complete 

To  upload  the  configuration  file  interactively: 

sw5 : admin>  configupload 

Protocol    (scp  or  ftp)    [ftp]:  ftp 

Server  Name  or  IP  Address   [host] :  123. 

.  123 . 123 . 123 

User  Name  [None] :  user21 

File  Name   [config.txt] :   conf ig-switch , 

.  txt 

Password:  xxxxxxxx 

upload  complete 
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See  also 

configDe fault 
conf igDownload 
conf igShow 
configure 
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configure 


Modifies  system  configuration  parameters. 


Synopsis 


configure 


Availability 

admin 


Description 

Use  this  command  to  change  the  following  system  configuration  parameters: 
Switch  fabric  settings 
Virtual  channel  settings 
Zoning  operation  parameters 
RSCN  transmission  mode 
Arbitrated  loop  parameters 
System  services 
Portlog  events  settings 
Application  attributes 


[—}f  NOTE:    If  executed  on  an  enabled  switch,  only  the  application  attribute  can  be  configured.  To  access  all 
parameters  controlled  by  this  command,  you  must  disable  the  switch  using  the  switchDisable 
command. 


The  configure  command  is  navigated  using  a  series  of  menus.  Top-level  and  associated  submenus 
consist  of  a  text  prompt,  a  list  of  acceptable  values,  and  a  default  value  (in  brackets). 


Use  the  following  options  to  control  input: 


Return 

Interrupt 
(Ctrl-C) 

End-of-f ile 
(Ctrl-D) 


When  entered  at  a  prompt  with  no  preceding  input,  accepts  the 
default  value  (if  applicable)  and  moves  to  the  next  prompt. 

Aborts  the  command  immediately  and  ignores  all  changes 
made.  This  keystroke  is  common  on  many  computers  but  can  be 
different  on  your  system. 

When  entered  at  a  prompt  with  no  preceding  input,  terminates 
the  command  and  saves  changes  made.  This  keystroke  is 
common  on  many  computers  but  might  be  different  on  your 
system. 


Switch  fabric  settings 

There  are  several  settings  that  control  the  overall  behavior  and  operation  of  the  fabric.  Some  of  these,  such 
as  the  domain,  are  assigned  automatically  by  the  fabric  and  might  differ  from  one  switch  to  another  in  the 
fabric.  Other  parameters,  such  as  the  BB  credit,  can  be  changed  for  specific  applications  or  operating 
environments  but  must  be  in  agreement  among  all  switches  to  allow  formation  of  the  fabric. 
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Table  5  lists  the  fabric  parameters  fields  and  their  settings. 
Table  5    Configure  command  fabric  parameters  fields 


Field 

Type 

Default 

Range 

Domain 

number 

1 

varies 

R_A_TOV 

number 

10000 

E_D_TOV  *  2  to  1 20000 

E_D_TOV 

number 

2000 

1 000  to  R_A_TOV  /  2 

WAN_TOV 

number 

0 

0  to  R_A_TOV  /  4 

MAX_HOPS 

number 

7 

7  to  19 

Data  Field  Size 

number 

21 12 

256  to  21 12 

Sequence  Level  Switching 

boolean 

0 

Oor  1 

Disable  Device  Probing 

boolean 

0 

Oor  1 

Suppress  Class  F  Traffic 

boolean 

0 

Oor  1 

Switch  PID  Format 

number 

1 

1  to  2 

Per- frame  Route  Priority 

boolean 

0 

Oor  1 

Long  Distance  Fabric 

boolean 

0 

Oor  1 

BB  Credit 

number 

16 

1  to  27 

Insistent  Domain  ID  Mode 

boolean 

0 

Oor  1 

Descriptions  of  the  switch  fabric  setting  fields  are  as  follows 
Domain 


R  A  TOV 


E  D  TOV 


WAN  TOV 


The  domain  number  uniquely  identifies  the  switch  in  a  fabric. 
This  value  is  automatically  assigned  by  the  fabric.  The  range  of 
valid  values  varies  depending  on  the  switch  model  and  other 
system  parameter  settings. 

The  resource  allocation  time  out  value  (R_A_TOV)  is  displayed  in 
milliseconds.  This  variable  works  with  the  variable  E_D_TOV  to 
determine  switch  actions  when  presented  with  an  error 
condition. 

Allocated  circuit  resources  with  detected  errors  are  not  released 
until  the  time  value  has  expired.  If  the  condition  is  resolved  prior 
to  the  time  out,  the  internal  time-out  clock  resets  and  waits  for  the 
next  error  condition. 

Error  detect  time  out  value  (E_D_TOV)  is  displayed  in 
milliseconds.  This  timer  is  used  to  flag  a  potential  error  condition 
when  an  expected  response  is  not  received  (an  acknowledgment 
or  reply  in  response  to  packet  receipt,  for  example)  within  the  set 
time  limit.  If  the  time  for  an  expected  response  exceeds  the  set 
value,  then  an  error  condition  occurs. 

Wide  area  network  time  out  value  (WANTOV)  displays  in 
milliseconds.  This  timer  is  the  maximum  frame  time  out  value  for 
a  WAN,  if  any,  interconnecting  the  Fibre  Channel  islands. 
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MAX_HOPS  Maximum  hops  (MAXJHOPS)  is  an  integer  that  denotes  the 

upper  limit  on  the  number  of  hops  a  frame  might  have  to  traverse 
to  reach  any  destination  port  from  any  source  port  across  the 
fabric. 


NOTE:   The  R_A_TOV,  E_D_TOV,  WANJOV,  and  MAX_HOPS  configuration  parameters  are 
inter-related.  Assigning  a  specific  value  to  one  or  more  of  these  parameters  can  change  the  range  of 
allowed  values  that  can  be  assigned  to  the  other  parameters.  As  a  result,  the  user  might  not  be  able  to  set 
all  the  values  within  the  range  displayed  against  each  parameter.  To  reduce  problems,  the  configuration 
utility  validates  the  modified  parameter  values  and  prompts  the  user  to  re-enter  some  values,  if  the 
validation  check  fails. 


Data  Field  Size 


Sequence-Level  Switching 


Disable  Device  Probing 


Suppress  Class  F  Traffic 


Switch  PID  Format 


Per-frame  Route  Priority 


Long  Distance  Fabric 


The  data  field  size  specifies  the  largest  possible  value,  in  bytes,  and 
advertises  this  value  to  other  switches  in  the  fabric  during  construction 
of  the  fabric  as  well  as  to  other  devices  when  they  connect  to  the 
fabric.  Setting  this  to  a  value  smaller  than  2112  might  result  in 
decreased  performance. 

When  sequence-level  switching  is  set  to  1,  frames  of  the  same 
sequence  from  a  particular  source  are  transmitted  as  a  group.  When 
this  feature  is  set  to  0,  frames  are  transmitted  interleaved  among 
multiple  sequences. 

Under  normal  conditions,  sequence-level  switching  should  be  disabled 
for  better  performance.  However,  some  host  adapters  have 
performance  issues  when  receiving  interleaved  frames  from  multiple 
sequences.  When  there  are  such  devices  attached  to  the  fabric, 
sequence-level  switching  should  be  enabled. 

When  disable  device  probing  is  set  to  1 ,  devices  that  do  not  register 
with  the  name  server  are  not  present  in  the  name  server  data  base.  Set 
this  mode  only  if  the  switch  NPort  discovery  process  (PLOGI,  PRLI, 
INQUIRY)  causes  an  attached  device  to  fail. 

When  this  mode  is  set  to  1,  all  Class  F  interswitch  frames  are 
transmitted  as  Class  2  frames.  This  is  to  support  remote  fabrics  that 
involve  ATM  gateways,  which  don't  support  class  F  traffic. 

The  formats  are  as  follows: 

0  Native  PID  format  (16  based,  1 6  port  format),  for  fabrics 
with  legacy  low-count-port  switches. 

1  Core  PID  format  (0  based,  256  port  format),  preferred 
mode  for  mixed  fabrics  with  legacy  and  new  switches. 

2  Extended  edge  PID  format  (16  based,  256  port  format), 
used  in  mixed  fabrics  with  legacy  and  new  switches  to 
avoid  need  to  reboot  host  systems  when  static  PID  binded  is 
used. 

In  addition  to  the  eight  virtual  channels  used  in  frame  routing  priority, 
support  is  also  available  for  per-frame-based  prioritization  when  this 
value  is  set.  When  Per-frame  Route  Priority  is  set  to  1 ,  the  virtual 
channel  ID  is  used  in  conjunction  with  a  frame  header  to  form  the  final 
virtual  channel  ID. 

When  this  mode  is  set  to  1 ,  ISLs  in  a  fabric  can  be  up  to  1 00  km  long. 
The  exact  distance  level  is  determined  by  the  per-port  configuration  on 
the  E_Ports  of  each  ISL.  Both  E  Ports  in  an  ISL  must  be  configured  to  run 
the  same  long-distance  level;  otherwise,  the  fabric  will  be  segmented. 
The  Extended  Fabric  License  is  required  to  set  this  mode. 
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NOTE:   An  HP  Extended  Fabrics  license  is  required  to  set  this  mode. 


BB  Credit  The  buffer-to-buffer  (BB)  credit  represents  the  number  of  buffers 

available  to  attached  devices  for  frame  receipt.  The  range  of  allowed 
values  varies  depending  on  other  system  settings. 

Insistent  Domain  ID  mode        This  mode  enables  a  flag  for  the  domain  ID,  so  that  the  current  domain 

setting  for  the  switch  is  insistent:  that  is,  remains  the  same  over  switch 
reboots,  power  cycles,  CP  failovers,  firmware  downloads,  and  fabric 
reconfigurations.  If  a  switch  does  not  get  the  selected  insistent  domain 
ID  during  a  fabric  reconfiguration,  it  segments  itself  out  of  the  fabric 

Virtual  channel  settings 

The  switch  enables  fine-tuning  for  a  specific  application  by  configuring  the  parameters  for  eight  virtual 
channels.  The  first  two  virtual  channels  are  reserved  for  switch  internal  functions  and  are  not  available  for 
modification. 

The  default  virtual  channel  settings  have  already  been  optimized  for  switch  performance.  Changing  the 
default  values  can  improve  switch  performance  but  can  also  degrade  performance.  Do  not  change  these 
settings  without  fully  understanding  the  effects  of  the  changes. 

Table  6  lists  the  virtual  channel  fields  and  their  settings. 


Table  6   Configure  command  virtual  channel  fields 


Field 

Default 

Range 

VC  Priority  2 

2 

2  to  3 

VC  Priority  3 

2 

2  to  3 

VC  Priority  4 

2 

2  to  3 

VC  Priority  5 

2 

2  to  3 

VC  Priority  6 

3 

2  to  3 

VC  Priority  7 

3 

2  to  3 

VC  Priority  specifies  the  class  of  frame  traffic  given  priority  for  a  virtual  channel. 

Zoning  operation  parameters 

The  zoning  operation  parameter  field  is  as  follows: 

Disable  NodeName  Specify  1  to  disable  using  node  WWN  when  specifying  nodes 
Zone  Checking  in  the  zone  database,  or  specify  0  to  enable  using  node  WWN 

when  specifying  nodes  in  the  zone  data.  The  default  value  is  0. 

This  value  must  be  set  to  1  for  interoperability. 
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RSCN  Transmission  mode 

Table  7  lists  the  RSCN  Transmission  Mode  fields  and  their  settings. 
Table  7    RSCN  transmission  modes 


Field 

Type 

Default 

Range 

End-device  RSCN  Transmission  Mode 

number 

1 

0to2 

Domain  RSCN  to  Enddevice  for  switch  IP  address  or  name  change 

number 

0 

Oto  1 

Descriptions  of  the  RSCN  Transmission  Mode  field  values  are  as  follows: 
End-device  RSCN  Transmission  Mode 


Domain  RSCN  to  End-device  for  switch 
IP  address  or  name  change 


Values: 
0 
1 

2 

Values  : 
0 

1 


RSCN  with  single  PID 
RSCN  with  multiple  PIDs 
Fabric  RSCN 


Disabled.  No  domain  RSCN  is  sent  to  the 
end-device  for  the  switch  IP  address  or  name 
change. 

Enabled.  Domain  RSCN  is  sent  to  the  end-device 
for  the  switch  IP  address  or  name  change. 


Arbitrated  Loop  parameters 

Table  8  lists  the  Arbitrated  Loop  Parameter  fields. 

Table  8   Configure  command  arbitrated  loop  settings 


Field 

Default 

Range 

Send  FAN  frames? 

1 

0  or  1 

Enable  CLOSE  on  OPEN  received? 

4 

Oto  4 

Always  send  RSCN? 

0 

0  or  1 

Descriptions  of  the  Arbitrated  Loop  Parameter  fields  are  as  follows 
Send  FAN  frames? 


Enable  CLOSE  on  OPEN 
received? 

Always  send  RSCN? 


Specifies  that  fabric  address  notification  (FAN)  frames  be  sent  to 
public  loop  devices  to  notify  them  of  their  node  ID  and  address. 
When  set  to  1 ,  frames  are  sent;  when  set  to  0,  frames  are  not 
sent. 

If  this  is  set,  a  CLS  is  returned  immediately  to  an  OPN  if  no 
buffers  are  available.  This  is  required  for  TachLite. 

Following  the  completion  of  loop  initialization,  a  remote  state 
change  notification  (RSCN)  is  issued  when  FL  Ports  detect  the 
presence  of  new  devices  or  the  absence  of  preexisting  devices. 
When  set,  a  RSCN  is  issued  upon  completion  of  loop 
initialization,  regardless  of  the  presence  or  absence  of  new  or 
pre-existing  devices. 
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System  Services 

Table  9  lists  the  system  services  fields  and  their  settings. 


Table  9   Configure  command  system  services  fields 


Field 

Default 

Rnnnp 
■\ui  iy 

rstatd 

Off 

On/Off 

rusersd 

Off 

On/Off 

telnetd 

On 

On/Off 

Descriptions  of  the  system  service  (setting)  fields  are  as  follows: 

rstatd  Dynamically  enables  or  disables  a  server  that  returns  system 

operation  information  through  remote  procedure  calls  (RPC).  The 
protocol  provides  for  a  wide  range  of  system  statistics. 

The  retrieval  of  this  information  is  supported  by  a  number  of 
operating  systems  that  support  RPC.  Most  UNIX-based  systems 
(HP-UX,  Irix,  Linux,  Solaris,  and  so  on.)  use  the  RUP  and 
RSYSINFO  commands  to  retrieve  the  information.  See  your  local 
system  documentation  for  the  appropriate  usage  of  the  these  or 
equivalent  commands. 

rusersd  Dynamically  enables  or  disables  a  server  that  returns  information 

about  the  user  logged  into  the  system  through  remote  procedure 
calls  (RPC).  The  information  returned  includes  user  login  name, 
system  name,  login  protocol  or  type,  login  time,  idle  time,  and 
remote  login  location  (if  applicable). 

The  retrieval  of  this  information  is  supported  by  a  number  of 
operating  systems  that  support  RPC.  On  most  UNIX-based 
systems  (HP-UX,  Irix,  Linux,  Solaris,  and  so  on.)  the  command  to 
retrieve  the  information  is  rusers.  See  your  local  system 
documentation  for  the  appropriate  usage  of  this  or  an  equivalent 
command. 

telnetd  Used  to  enable  or  disable  the  telnet  interface  to  a  switch, 

including  sectelnet.  If  you  are  using  SSH  to  manage  a  switch, 
you  can  disable  the  telnet  interface  for  greater  security.  The 
default  value  is  on  (telnet  enabled). 

Portlog  Events  Enable 

Port  events  can  be  disabled  from  logging.  The  default  is  enabled  (on).  When  disabled,  this  event  is  not 
logged  by  the  port  log. 

Application  Attributes 

Application  attributes  HTTP,  SNMP,  and  RPCd  are  configurable;  by  default,  all  three  attributes  are 
enabled.  See  Table  10  for  the  application  attributes  that  can  be  changed. 


Table  10    Configurable  application  attributes 


Application 

File 

Type 

Default 

Range 

SSL 

Certificate  File 

string 

not  set 

varies 

CA  Certificate  File 

string 

not  set 

varies 

Length  of  crypto  key 

number 

128 

40,  56,  1  28 
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Table  10   Configurable  application  attributes  (continued) 


Application 

File 

Type 

Default 

Range 

SNMP 

SNMP  Security  Level 

number 

0 

0,  1,  2 

cfgload 

Secure  Config  Upload  and  Download 

boolean 

off 

on/ off 

\^)f  NOTE:   The  secure  protocols  must  not  be  enabled  before  setting  SSL  attributes  correctly. 


Operands 

none 
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Examples 

To  set  the  configuration  parameters  for  a  switch: 

switch : admin>  configure 
Configure . . . 

Fabric  parameters (yes ,   y,   no,   n) :    [no]  yes 

Domain:  (1.  .239)  [1] 

R_A_TOV:    (4000. .120000)  [10000] 

E_D_TOV:    (1000.. 5000)    [2000]  5000 

WAN_TOV:    (0.. 30000)    [0]  0 

MAX_HOPS:    (7. .19)  [7] 

Data  field  size:    (256.. 2112)  [2112] 

Sequence  Level  Switching:    (0..1)    [0]  1 

Disable  Device  Probing:    (0..1)  [0] 

Switch  PID  Format:    (1..2)  [1] 

Per-frame  Route  Priority:    (0..1)  [0] 

BB  credit:    (1.  .16)  [16] 

Insistent  Domain  ID  Mode   (yes,   y,   no,   n) :  [no] 
Virtual  Channel  parameters (yes ,   y,   no,   n) :    [no]  yes 


vc 

Priority 

2  : 

(2  . 

.3) 

[2] 

vc 

Priority 

3  : 

(2  . 

.3) 

[2] 

vc 

Priority 

4  : 

(2  . 

.3) 

[2] 

vc 

Priority 

5  : 

(2  . 

.3) 

[2] 

vc 

Priority 

6  : 

(2  . 

.3) 

[3] 

vc 

Priority 

7  : 

(2  . 

.3) 

[3] 

Switch  Operating  Mode   (yes,   y,   no,   n) :    [no]  yes 
Interoperability  Mode:    (0..1)  [0] 

Zoning  Operation  parameters   (yes,  y,   no,   n) :    [no]  yes 
Disable  NodeName  Zone  Checking:    (0..1)  [0] 
RSCN  Transmission  Mode   (yes,   y,   no,   n) :    [no]  yes 
End-device  RSCN  Transmission  Mode 

(0  =  RSCN  with  single  PID,  1  =  RSCN  with  multiple  PIDs,  2  =  Fabric 
RSCN):    (0..2)  [0] 

(continued  on  next  page) 
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Arbitrated  Loop  parameters  (yes ,   y,   no,   n)  :    [no]  yes 

/ixuernace  tm  creoic.    \v  .  .±)  luj 

Enable  CLOSE  on  OPEN  received?:    (0..1)  [0] 

Always  send  RSCN? :    (0..1)  [0] 

Do  Not  Allow  AL_PA  0x00?:    (0..1)  [0] 

System  services (yes ,   y,   no,   n) :    [no]  yes 

t a  f-  sa  1-rl  (  r\Ti       ri  f  ■f  \  ■      \  r\  ■f  -f  1 
IbLaLU               U1L  j  .      L  O  X  X  J 

I  Ubcl  oU  \  Ull,     \J  i- i- )  .      i  D  X  J_  J 

telnetd   (on,   off) :  [on] 

ir  UI  LIUy    fc=  V  t=Il  L-  o    t=Iia.UX  ci        lycb  ,     y  ,     I1U  ,     11 )  .      ]_  LLU  J  ycb 

fc>  L&X  L\a    sWl              fa  Lax  L-    OX     X  fc=    o  Lax  L     fc:  V  till  L           }                \  Oil ,     O  X  X  )  . 

L  on  j 

disable (a  port  is  disabled                                 )          (on,  off) 

:  [on] 

enable(a  port  is  enabled                                   )          (on,  off): 

[on] 

ioctl(a  port  I/O  control  is  executed)         )          (on,  off): 

[on] 

( output  truncated) 

Committing  configuration. . .done. 

See  also 

agtCf gDef ault 
agtCfgSet 
agtCf gShow 
configDe fault 
conf igShow 
ipAddrSet 

portCf gLongDi stance 
switchDi sable 
switchEnable 
upTime 
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cross  PortTest 


Tests  functional  operation  of  port  external  transmit  and  receive  path. 

Synopsis 

crossporttest   [-nframes  count] [-lb_mode  mode]  [-spd_mode  mode]  [-norestore 
mode]  [-ports  itemlist] 

Availability 

admin 

Description 

This  command  verifies  the  intended  functional  operation  of  the  switch  by  sending  frames  from  port  M's 
transmitter  and  looping  them  back  through  an  external  fiber  cable  into  port  N's  receiver,  thus  exercising 
all  the  switch  components,  from  the  main  board,  to  the  media,  to  the  fiber  cable,  to  the  media,  and  back 
to  the  main  board.  With  -lb_mode  set  to  1 ,  it  is  also  possible  to  test  ports  with  loopback  plugs  that 
connect  each  port  back  to  itself. 

The  cables  can  be  connected  to  any  port  combination  with  the  one  condition;  the  cables  and  media 
connected  must  be  of  the  same  technology.  This  means  a  short  wave-length  media  port  must  be  connected 
to  another  short  wave-length  media  port,  using  a  short  wave-length  cable,  a  long  wave-length  port  must 
be  connected  to  a  long  wave-length  port,  and  a  copper  port  must  be  connected  to  a  copper  port. 

For  best  coverage,  connected  ports  should  be  from  different  ASICs.  For  example,  Ports  0  through  3  belong 
to  ASIC  0,  ports  4  through  7  belong  to  ASIC  1 ,  and  so  forth.  A  connection  from  port  0  to  port  1 5 
exercises  the  transmit  path  between  ASICs.  A  connection  from  port  0  to  port  3  tests  only  the  internal 
transmit  path  in  ASIC  0. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  flicker  green  while  the  test  is 
running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  connected  to  each  other. 

2.  Enable  ports  for  cabled  loopback  mode. 

3.  Create  a  Frame  F  of  maximum  data  size  (2112  bytes). 

4.  Transmit  Frame  F  through  Port  M. 

5.  Pick  up  the  frame  from  its  cross-connected  Port  N.  An  error  is  reported  if  any  port  other  than  N  actually 
received  the  frame. 

6.  Check  if  any  of  the  eight  statistic  error  counters  are  nonzero:  ENC_in,  CRC_err,  TruncFrm,  FrmTooLong, 
BadEOF,  Enc_out,  BadOrdSet,  or  DiscC3. 

7.  Check  if  the  transmit,  receive,  or  Class  3  receiver  counters  are  stuck  at  some  value. 

8.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

9.  Repeat  steps  3  through  8  for  all  ports  present  until  the  number  of  frames  requested  is  reached  or  all 
ports  are  marked  bad. 
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At  each  pass,  a  different  data  type  is  used  to  create  the  frame  from  a  palette  of  seven  types  meaning  that 
if  a  pass  of  seven  is  requested,  seven  different  frames  are  used  in  the  test.  If  eight  passes,  the  first  seven 
frames  are  unique,  and  the  eighth  is  the  same  as  the  first.  The  data  palette  of  seven  are: 


CSPAT: 

0x7e, 

0x7  e, 

0x7e, 

0x7e, 

BYTE_LFSR : 

0x69, 

0x01, 

0x02  , 

0x05, 

CHALF_SQ  : 

0x4a, 

0x4a, 

0x4a, 

0x4a, 

QUAD_NOT : 

0x00, 

Oxf  f , 

0x00, 

Oxff , 

CQTR_SQ : 

0x7  8, 

0x78, 

0x78, 

0x7  8, 

CRPAT : 

Oxbc, 

Oxbc, 

0x2  3, 

0x47  , 

RANDOM : 

0x2  5, 

0x7  f, 

0x6e, 

0x9a, 

The  crossPortTest  command  behavior  depends  on  the  modes  activated. 
SwitchEnable  or  SwitchDisable  mode 

In  online  mode  (in  which  the  switch  is  enabled  prior  to  executing  the  crossPortTest  command),  only 
ports  that  are  cable  loopbacked  to  ports  in  the  same  switch  are  tested.  Ports  connected  outside  of  the 
switch  are  ignored. 

To  run  the  crossPortTest  command  successfully  the  test  must  find  at  least  one  port  (lb_mode  =  1, 
this  is  the  default)  or  two  ports  (lb_mode  =  0)  cable  loopbacked  to  each  other.  If  this  criteria  is  not  met, 
one  of  the  following  message  is  displayed: 

Need  at  least  1  port(s)   connected  to  run  this  test. 

Need  at  least  2  port(s)   cross-connected  to  run  this  test. 

In  offline  mode  (when  the  switch  is  disabled  prior  to  executing  the  crossPortTest  command)  all  ports 
are  assumed  to  be  cable  loopbacked  to  different  ports  in  the  same  switch.  If  one  or  more  ports  are  not 
connected,  the  test  aborts. 

NOTE:  All  ports  must  be  connected  using  loopback  plugs  or  loopback  cables  for  this  test  to  run  correctly 
in  offline  mode. 


The  test  determines  which  port  is  connected  to  which  port  transmitting  frames.  If  any  ports  are  not  properly 
connected  (improperly  seated  SFPs  or  cables,  bad  SFPs  or  cables,  or  improper  connection  or  improper 
connection  of  SWL  to  LWL),  the  following  message  is  displayed: 

One  or  more  ports  is  not  active,   please  double  check 

fibre  channel  connections  on  all  ports. 

Since  this  test  includes  the  media  and  the  fiber  cable  in  its  test  path,  its  results  combined  with  the  results  of 
portLoopbackTest  and  spinSilk  can  be  used  to  determine  which  components  of  the  switch  are 
faulty.  It  is  also  possible  to  use  loopback  modes  3  and  5  to  further  isolate  failures;  see  -lb_mode,  below. 


This  command  has  the  following  operands: 

-nframes  count    Specify  the  number  of  frames  to  send.  The  test  will  progress  until  the  specified 
number  of  frames  has  been  transmitted  on  each  port.  The  default  value  is  1 0. 

-lb_mode  mode      Specify  the  loopback  mode  for  the  test.  By  default,  crossPortTest  uses  mode 
1  port  loopback.  Valid  values  are: 


0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 
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-spd_mode  mode    Specify  the  speed  mode  for  the  test.  This  parameter  is  used  only  for  Bloom  and 
Condor  ASIC-based  products,  for  which  it  controls  the  speed  at  which  each  port 
is  operated.  For  1  Gb/s-only  products  it  is  ignored.  The  exact  operation  of  each 
mode  5  through  8  depends  upon  the  loopback  mode  selected.  When  speed 
modes  5  through  8  are  used  with  cables,  they  must  be  connected  even  to  odd  or 
the  test  will  fail.  Valid  values  are: 

0  Run  test  at  both  1  Gb/s,  2  Gb/s,  and  4  Gb/s  (default) 

1  Set  all  port  speeds  to  1  Gb/s 

2  Set  all  port  speeds  to  2  Gb/s 
4  Set  all  port  speeds  to  4  Gb/s 

For  -lb_mode  set  to  0  or  1 ,  the  following  speed  modes  are  available  to  test  the 
speed  negotiation: 

3  Set  all  even  ports  speed  to  AN;  set  all  odd  ports  speed  to  1 
Gb/s. 

4  Set  all  even  ports  speed  to  AN;  set  all  odd  ports  speed  to  2 
Gb/s. 

5  Set  all  odd  ports  speed  to  AN;  set  all  even  ports  speed  to  1 
Gb/s. 

6  Set  all  odd  ports  speed  to  AN;  set  all  even  ports  speed  to  2 
Gb/s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun: 

3.5  Set  all  even  ports  speed  to  2  Gb/s;  set  all  odd  ports  speed  to 

1  Gb/s. 

4.6  Set  all  even  ports  speed  to  1  Gb/s;  set  all  odd  ports  speed  to 

2  Gb/s. 

-norestore     Specify  1  to  force  the  test  to  skip  part  of  the  POST  cleanup 
mode  normally  performed.  This  might  be  helpful  during  debug.  This 

parameter  should  normally  be  left  at  the  default  value  of  0. 

-ports  Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports 

itemlist         in  the  current  switch  will  be  used.  See  itemList  for  more 
information. 


Examples 


To  run  a  functional  test  of  all  the  ports  on  a  switch: 

switch: admin>  crossporttest  -ports  1/0-1/15 

Running  crossporttest   


Ports  Segmented  (0) 
Executing  test   . . . 

Test  Complete:    "crossporttest"  Pass  10  of  10 
Duration  0  hr,    0  min  &  8  sec  (0:0:8:725). 
passed. 


See  also 

caraTest 


centralMemoryTest 
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cmemRetentionTest 

cmiTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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dataTypeShow 

Displays  sample  data  stream  types  used  in  some  diagnostic  commands. 

Synopsis 

datatypeshow   [-seed  value] 

Availability 

all  users 

Description 

Use  this  command  to  display  sample  data  stream  types  used  in  diagnostic  commands.  There  are  20 
different  sample  data  types.  The  command  displays  an  example  of  each  data  stream. 

Operands 

This  command  has  the  following  operand: 

-seed  value  Specify  the  data  pattern  seed  value.  If  no  seed  is  specified,  then 

a  seed  value  of  0  is  used. 

Examples 

To  display  sample  data  streams  you  can  use  with  diagnostics: 

switch : admin>  datatypeshow 

Pattern  type  example 


BYTE_FILL 

1 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00 

00  00 

WORD_FILL 

2 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

0000 

QUAD_FILL 

3 

00000000 

00000000 

00000000 

00000000 

BYTE_NOT 

4 

00 

ff 

00 

f  f 

00 

ff 

00 

f  f 

00 

f  f 

00 

f  f 

00 

ff 

00  ff 

WORD_NOT 

5 

0000 

f  ff  f 

0000 

ff  ff 

0000 

ff  ff 

0000 

f  ff  f 

QUAD_NOT 

6 

00000000 

ff ff ff ff 

00000000 

f fff ff ff 

BYTE_RAMP 

7 

00 

01 

02 

03 

04 

05 

06 

07 

08 

09 

0a 

0b 

0c 

Od 

Oe  Of 

WORD_RAMP 

8 

0000 

0001 

0002 

0003 

0004 

0005 

0006 

0007 

QUAD_RAMP 

9 

00000000 

00000001 

00000002 

00000003 

BYTE_LFSR 

10 

69 

01 

02 

05 

0b 

17 

2f 

5e 

bd 

7b 

f6 

ec 

d8 

bO 

60  cO 

RANDOM 

11 

55 

16 

fc 

d7 

17 

65 

a9 

87 

5f 

44 

be 

5a 

dO 

de 

be  a5 

CRPAT 

12 

be 

be 

23 

47 

6b 

8f 

b3 

d7 

fb 

14 

36 

59 

be 

be 

23  47 

CSPAT 

13 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e  7e 

CHALF_SQ 

14 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a 

4a  4a 

CQTR_SQ 

15 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78 

78  78 

RDRAM_PAT 

16 

00 

ff 

00 

ff 

00 

ff 

00 

f  f 

00 

f  f 

00 

f  f 

00 

f  f 

00  ff 

j  CRPAT 

17 

be 

d7 

23 

47 

6b 

8f 

b3 

14 

5e 

fb 

35 

59 

be 

d7 

23  47 

jCJTPAT 

18 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e 

7e  7e 

j  CSPAT 

19 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f 

7f  7f 

PRED_RAND 

20 

00000000 

11111111 

22222222 

33333333 
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date 


Displays  or  sets  the  switch  date  and  time. 

Synopsis 

date  ["newdate"] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  set  the  date  and  time.  All  switches  maintain  the  current  date  and  time  in  flash 
memory.  If  the  security  feature  (secure  mode)  is  not  enabled,  switch  operation  does  not  depend  on  the 
date  and  time.  A  switch  with  incorrect  date  values  continues  to  function  properly.  The  date  and  time  are 
only  used  to  record  events  in  the  various  logs:  for  example,  the  error  log  and  the  port  log. 

To  enable  secure  mode  the  fabric  must  be  synchronized.  Every  switch  in  the  fabric  must  receive  a  fabric 
timestamp  from  the  primary  FCS  switch. 

Use  this  command  with  no  operands  to  display  the  local  switch  date  and  time.  Specify  an  operand  to  set 
the  date  and  time. 

This  command  sets  a  common  date  and  time  for  the  entire  fabric.  If  secure  mode  is  not  enabled,  a  change 
in  date  or  time  to  one  switch  is  forwarded  to  the  principal  switch  and  distributed  to  the  fabric.  If  secure 
mode  is  enabled,  date  or  time  changes  can  be  made  only  on  the  primary  FCS  switch  and  distributed  to 
the  fabric. 

It  might  take  up  to  64  seconds  for  the  switches  in  the  fabric  to  be  synchronized. 

If  the  switches  in  the  fabric  are  4.1  .x,  3.1  .x,  or  2.6.x  or  higher,  this  command  sets  date  and  time  for  all 
switches  in  the  fabric.  If  secure  mode  is  disabled,  a  change  in  date  and  time  to  one  switch  is  forwarded  to 
the  principal  switch  and  distributes  to  the  fabric. 


ptyf  NOTE:  This  command  becomes  read-only  if  external  NTP  synchronization  is  enabled.  For  more 
t— I    information,  see  tsClockServer. 


The  date  specified  is  always  the  local  switch  time,  taking  into  account  daylight  saving  time  and  the  time 
zone  setup  of  the  switch.  Each  switch  takes  care  of  converting  the  GMT  time  distributed  fabric-wide  to  its 
local  time.  See  tsTimeZone  for  more  information  on  time  zone  support. 

If  the  switch  is  operating  in  FICON  Management  Server  mode  (fmsmode),  setting  the  date  is  subject  to  the 
director  clock  alert  mode  (DCAM).  If  DCAM  is  1 ,  the  operator  issues  a  warning  that  the  switch  date  is 
about  to  change.  The  operator  then  prompts  to  confirm  the  change  with  a  yes  or  no  response. 

The  date  and  time  are  specified  in  the  following  format,  as  used  on  many  UNIX  systems: 

mmddHHMMyy 

where: 

mm  is  the  month,  01  -1 2 
dd  is  the  date,  01-31 
hh  is  the  hour,  00-23 
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mm  is  minutes,  00-59 


yy  is  the  year,  00-99 

If  you  enter  any  value  in  the  range  00-69,  then  the  year  displayed  will  be  2000-2069.  For  example,  if 
you  enter  the  value  04,  then  the  year  displayed  will  be  2004.  If  you  enter  any  value  between  70-99  in  the 
year  field  (yy),  the  year  displayed  will  be  in  the  range  1 970-1 999.  For  example  if  you  enter  80  for  yy, 
then  the  year  displayed  will  be  1980. 

Operands 

This  command  has  the  following  operand: 

newdate  Specify  the  new  date  and  time,  in  quotation  marks.  This  operand 

is  optional. 

Examples 

To  display  the  current  date  and  time  and  then  modify  it: 


switch : admin> 

date 

Fri  Jan  29  17: 

:01:48 

UTC  2  000 

swi  tch : admin> 

date 

"0227123003" 

Thu  Feb  27  12 : 

:30:00 

UTC  2003 

See  also 

errShow 


f iconcupset 

f iconcupshow 

portLogShow 

tsClockServer 

tsTimeZone 

upTime 
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dbgShow 

Displays  current  values  of  debug  and  verbosity  levels  of  the  specified  module. 

Synopsis 

dbgshow  module_name 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  values  of  debug  and  verbosity  levels  of  the  specified  module.  If  no 
module  name  is  specified,  displays  debug  and  verbosity  levels  of  all  modules. 

Operands 

This  command  has  the  following  operands: 

module_name  Specify  the  name  of  the  module  for  which  you  want  to  view  the 

debug  and  verbosity  levels.  Module  names  are  case  sensitive. 
This  operand  is  optional. 

Examples 

To  display  information  about  a  specific  module  named  NS: 

switch : admin>  dbgshow  NS 

Module  NS,  debug  level  =  1,  verbose  level  =  1 

See  also 

setDbg 
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diagClearError 

Clears  the  diagnostics  failure  status. 

Synopsis 

diagclearerror   [[--slot]   slotnumber]  -all 

Availability 

admin 

Description 

Use  this  command  to  clear  the  diagnostics  failure  status. 

Operands 

This  command  has  the  following  operands: 

[--slot]   slotnumber       Specify  the  slot  to  clear  the  diagnostics  failure  status.  The  default  is  set 

to  0  and  designed  to  operate  on  fixed-port-count  products. 

-all  If  specified,  all  blades  clear. 

If  no  operand  is  specified,  the  default  is  to  clear  all  bad  port  flags. 

Examples 

To  clear  the  diag  software  flag: 

switch : admin>  diagclearerror  1 

Oxlbcb   (fabos) :     Switch:   0,   Error  DIAG-CLEARERR,  3, 
Pt5  Sll  ChO  Qdl  Diagnostics  Error  Cleared 
Err#  0120041  0105 

See  also 

none 
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d  iagCom  ma  ndShow 


Displays  diagnostic  command  descriptions. 


Synopsis 

diagcommandshow  [command] 

Availability 

all  users 

Description 

Use  this  command  to  display  a  short  description  of  a  diagnostic  command. 


j^f  NOTE:    Use  diagHelp  to  look  up  diagnostic  command  help  pages. 
Options 

This  command  has  the  following  options: 
command  Specify  a  command  name  to  display  more  detailed  information. 


Examples 


To  display  a  list  of  diagnostic  commands,  with  descriptions: 


switch : admin>  diagcommandshow 

bl adepropshow 

display 

blade  properties 

chippropshow 

display 

chip  properties 

chipregshow 

display 

contents  of  port  registers 

datatypeshow 

display 

available  diagnostic  data  types 

di  age  ommandshow 

display 

diagnostic  command  descriptions 

diaghelp 

display 

diagnostic  command  descriptions 

diagmodeshow 

display 

diagnostic  mode  configuration 

diagoktorun 

check  to 

see  if  it  is  ok  to  run  a  diagnostic  test 

diagshow 

display 

diagnostics  status 

diagstatus 

display 

currently  running  diagnostic  tests 

itemlist 

diagnostic  list  parameter  syntax  and  grammar 

information 

minispropshow 

display 

mini-switch  ASIC  property 

minisregshow 

display 

contents  of  mini-switch  registers. 

ptbuf show 

dump  port  buffer  contents 

(output  truncated) 

See  also 


diagHelp 
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diagDisablePost 

Disables  power-on  self-test  (POST). 

Synopsis 

diagdisablepost 

Availability 

admin 

Description 

Use  this  command  to  disable  POST.  A  reboot  is  not  required  for  this  command  to  take  effect. 


f2^f  NOTE:   This  command  disables  POST  on  both  Core  Switch  2/64  logical  switches. 


Operands 

none 

Examples 

To  disable  the  POST  during  future  powerons: 

switch: admin>  diagdisablepost 
Config  update  Succeeded 
Diagnostic  POST  is  now  disabled. 

See  also 

diagEnablePost 


142   Fabric  OS  commands 


diagEnablePost 


Enables  power-on  self-test  (POST)  execution  at  next  reboot. 


Synopsis 

diagenablepost 

Availability 

admin 

Description 

Use  this  command  to  enable  POST.  A  reboot  is  not  required  for  this  command  to  take  effect.  POST  includes 
two  phases:  POST  Phase  I  mainly  tests  hardware  and  POST  Phase  II  tests  system  functionality. 


f2^f  NOTE:   This  command  disables  POST  on  both  Core  Switch  2/64  logical  switches. 


Operands 


none 


Examples 


To  enable  the  POST  during  future  power-ons: 


switch : admin>  diagenablepost 


Config  update  Succeeded 


Diagnostic  POST  is  now  enabled. 


See  also 


diagDisablePost 
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diagEnv 

Diagnostic  debug  parameters  management  package. 

Synopsis 

diagsetdebug  value 
diagdebughelp 

diagsetdebugnoncheck  value 

diagsetdebugnorestore  value 

diagsetf aillimit  value 

diagsetf rcerr  value 

diagshowusr 

...  more  commands  ... 

Availability 

admin 

Description 

All  of  diagnostic  parameters  can  be  set  either  by  running  relevant  user  commands  or  by  setting  them 
directly  in  some  way.  The  latter  method  is  supposed  to  be  run  only  by  in-house  technicians  but  users. 
Diagnostic  parameters  are  used  primarily  for  debugging  purposes  and  users  should  not  tamper  with  those 
if  not  told  so. 

To  display  the  values  of  diagnostic  parameters,  run  diagshowusr  as  shown  in  the  "Examples"  section. 
For  a  complete  list  of  the  diagEnv  commands,  use  diagdebughelp. 

Each  of  these  commands  is  an  alias  that  evaluates  the  output  of  diagenv  to  set  the  diagnostic  parameter 
for  the  current  shell.  For  example  the  following  alias  is  created  to  implement  diagsetdebug. 

function  diagsetdebug  ()    {  eval  "diagenv  write  USR_DEBUG  $*N  } 

These  aliases  are  created  by  diagEnv  as  well  by  including  the  following  command  in  the  shell  start-up 
script: 

eval  "diagenv  alias" 

For  proper  operation  the  output  diagEnv  sends  to  stdout  should  be  processed  by  the  eval  command  to 
set  the  appropriate  variables. 


A CAUTION:  Your  use  of  the  functionality  made  available  through  this  package  is  at  your  sole  risk  and  you 
assume  all  liability  resulting  from  such  use. 


I^f  NOTE:    The  effects  of  diagnostic  parameters  might  be  changed  without  notice. 


Operands 

This  command  has  the  following  operand: 

value  Specify  the  value  for  the  relevant  diagnostic  environment  variable. 
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Examples 

To  display  the  values  of  the  diagnostic  parameters: 


switch : admin> 

diagshowusr 

Name 

Environment 

Value 

USR_DILATION 

D I AG_U S  R_DL Y_D I LAT I ON 

1 

USR_MEMDLY 

DIAG_USR_MEMDLY 

10 

USR_SEED 

DIAG_USR_SEED 

0x0 

USR_SPECIAL 

DIAG_USR_SPECIAL 

0x0 

(output  truncated) 

See  also 

none 
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diagFailLimit 

Sets  the  diagnostics  fail  limit. 

Synopsis 

diagf aillimit   [limit   |  -show] 

Availability 

admin 

Description 

Use  this  command  to  set  the  diagnostics  fail  limit  to  a  specified  value.  The  fail  limit  controls  the  number  of 
failures  before  certain  diagnostic  test  methods  aborts.  The  exact  use  of  this  configuration  setting  depends 
on  the  test  method. 

The  fail  limit  is  saved  in  flash  memory  and  stays  set  until  the  next  execution  of  diagFailLimit. 

The  new  fail  limit  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to 
take  effect. 

Operands 

This  command  has  the  following  operands: 

limi  t  Specify  the  number  of  failures  before  a  diagnostic  test  aborts. 

The  limit  value  must  be  1  or  greater.  This  operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  fail  limit  setting.  This 

operand  is  optional. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  change  the  fail  limit  from  1  to  5: 

switch : admin>  diagf aillimit  -show 

Fail  Limit  is  1. 

switch : admin>  diagf aillimit  5 

Fail  Limit  is  now  5 . 

Config  update  Succeeded 

See  also 

none 
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diagHelp 

Displays  diagnostic  command  information. 

Synopsis 

diaghelp  [command] 

Availability 

all  users 

Description 

Use  this  command  to  display  a  short  description  of  diagnostic  commands  that  are  available  to  the  user  if 
command  is  not  specified.  The  command  builds  a  database  of  command  information  during  the  first 
execution.  This  process  takes  a  few  seconds  to  complete. 


^2yf  NOTE:  Use  default  operands  when  running  diagnostics  commands.  Nondefault  settings  require  detailed 
knowledge  of  the  underlying  hardware  and  are  intended  for  support  personnel  only.  Contact  HP  customer 
support  if  you  wish  to  use  these  operands. 


Operands 

This  command  has  the  following  operand: 

command  Specify  a  command  name  to  display  more  detailed  information. 

Examples 

To  display  diagnostic  command  information: 


switch : admin>  diaghelp 

bl adepropshow 

display 

blade  properties 

chippropshow 

display 

chip  properties 

chipregshow 

display 

contents  of  port  registers 

datatypeshow 

display 

available  diagnostic  data  types 

di  age  ommandshow 

display 

diagnostic  command  descriptions 

diaghelp 

display 

diagnostic  command  descriptions 

diagmodeshow 

display 

diagnostic  mode  configuration 

diagoktorun 

check  to 

see  if  it  is  ok  to  run  a  diagnostic  test 

diagshow 

display 

diagnostics  status 

diagstatus 

display 

currently  running  diagnostic  tests 

mini  spropshow 

display 

ASIC  pair  property 

minisregshow 

display 

contents  of  ASIC  pair  registers. 

ptbuf show 

dump  port  buffer  contents 

(output  truncated) 

See  also 

none 


Fabric  OS  5.x  command  reference  guide  147 


diagLoopId 


Sets  the  diagnostics  loop  ID. 


Synopsis 


diagloopid   [id  |  -show] 


Availability 


admin 


Description 


Use  this  command  to  select  the  loop  ID  to  be  used  by  FL  mode  diagnostics.  The  value  entered  will  be 
converted  from  a  loop  ID  to  the  corresponding  AL  PA  and  used  as  the  port  address  for  any  diagnostics 
that  operate  in  FLPort  mode. 

The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot  to  take  effect. 
The  actual  behavior  of  diagLoopId  depends  on  the  test  methods  that  use  it. 

f2^f  NOTE:    Currently,  no  FL  mode  tests  exist. 


Operands 


This  command  has  the  following  optional  operands: 


id 


-show 


Specify  the  loop  ID  for  FL  Port  mode  diagnostics. 
Specify  -show  to  display  the  current  loop  ID. 


If  no  operand  is  specified,  the  current  value  is  displayed. 


Examples 


To  display  the  loop  ID: 


switch : admin>  diagloopid  -show 


FL  mode  Loop  ID  is  125. 


Notes 


Currently,  no  FL  Port  mode  tests  exist. 
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diagModeShow 

Displays  diagnostic  mode  configuration. 

Synopsis 

diagmodeshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  settings  for  several  diagnostic  configuration  parameters.  This 
command  is  most  often  used  by  burn-in  scripts  to  display  a  summary  of  the  configuration  settings  that  were 
in  effect  when  the  script  was  run. 


f2^f  NOTE:  Any  automated  use  of  this  command  should  rely  only  on  the  names  of  the  specific  variables,  not 
t— I    on  their  exact  positions  in  the  output.  Earlier  versions  of  this  command  listed 

diag.  mode.  burnin.nExec  instead  of  Burnin  nExec  and  listed  diag  .mode .  burnin .  nExec 
instead  of  Burnin  passnum. 


Operands 

none 

Examples 

To  display  the  diagnostic  mode: 


switch : admin>  diagModeShow 

diag. mode*  parameters  saved  in  flash: 

diag 

.mode 

burnin 

=  0 

diag 

.  mode 

burnin 

level 

=  0 

diag 

.mode 

burnin 

f irstPowerUp 

=  Thu  Feb  28  01:36:12  2002 

diag 

.mode 

esd 

=  0 

diag 

.  mode 

gbic 

=  0 

diag 

.mode 

splb 

=  0 

diag 

.mode 

lab 

=  0 

diag 

.mode 

mf  g 

=  0 

diag 

.  mode 

bplb 

=  0 

diag . 

ports 

=  TEST    (type=INDEX,    sz=512):  100. 

Burnin  passnum 

=  1 

Burnin  nExec 

=  0 

Silkworm  Mode 

=  OFF 

Disable  Modes  Print 

=  OFF 
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See  also 

burninLevel 
setEsdMode 
setGbicMode 
setSplbMode 
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diagPost 

Sets  or  displays  diagnostic  POST  configuration. 

Synopsis 

diagpost   [mode   |  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  POST  testing.  The  mode  is  saved  in  flash  memory  (and  stays  in 
that  mode)  until  the  next  execution  of  diagPost.  The  mode  becomes  active  as  soon  as  this  command  is 
executed;  it  does  not  require  a  reboot  to  take  effect. 

POST  mode  modifies  the  behavior  of  the  diagnostics  daemon  program  to  inhibit  testing  of  switch  blades 
when  the  system  is  first  powered  on  or  a  new  blade  is  added. 

NOTE:    To  enable  or  disable  diagnostic  POST,  the  recommended  method  is  to  use  diagEnablePost 
and  diagDisablePost. 


Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  to  enable,  0  to  disable  POST  test, 

-show  Specify  this  operand  to  display  the  current  mode. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  enable  and  then  disable  the  POST  test: 

switch :admin>  diagpost 

Diagnostic  POST  is  currently  disabled, 
switch :admin>  diagpost  1 
Config  update  Succeeded 
Diagnostic  POST  is  now  enabled. 

See  also 

diagDisablePost 
diagEnablePost 
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diagRetry 

Sets  or  displays  diagnostic  retry  mode. 

Synopsis 

diagretry   [mode   |  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  retry  mode  if  the  mode  value  is  nonzero  and  to  disable  the  retry  mode  if  the 
mode  value  is  0.  The  mode  is  saved  in  flash  memory  (and  stays  in  that  mode)  until  the  next  execution  of 
diagRetry.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does  not  require  a  reboot 
to  take  effect. 

Retry  mode  modifies  the  behavior  of  the  diagnostic  test  methods,  power-on  self-test  (POST),  and  burn-in 
scripts.  The  exact  behavior  depends  on  the  tests  and  scripts  that  are  run. 

Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  to  enable,  0  to  disable  retry  mode. 

-show  Specify  this  operand  to  display  the  current  mode  setting. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  view  the  current  retry  mode  value: 

switch : admin>  diagretry  -show 

Diagnostic  Retry  Mode  is  currently  enabled. 
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diagSetBurnin 

Initializes  the  blade  for  a  burn-in  run. 

Synopsis 

diagsetburnin   [--slot  slotnumber]  [script    |  -current] 

Availability 

admin 

Description 

This  sets  up  the  blade  burn-in  parameters  for  the  registered  burn-in  script.  The  burn-in  will  start  at  the  next 
run  of  power-on  self-test  (POST)  on  the  designated  blades. 

The  errors  and  activity  logs  are  stored  in  flash  memory.  The  activity  log  of  the  script  is  saved  in 
/var/log/scriptname. slot. log.  The  errors  produced  are  available  from  the  burninErrShow 
command  on  a  per-blade  basis.  When  power  cycles  occur,  the  burn-in  activity  is  restarted  at  the  test  that 
was  interrupted  at  the  time  of  the  power  cycle.  This  command  does  not  require  a  reboot  to  take  effect. 

'2^>  NOTE:    Boards  must  be  installed  prior  to  running  this  command  and  diagSetCycle  must  be  run  prior  to 
diagSetBurnin  if  you  want  to  use  both  commands. 


[22*5?  NOTE:    HP  StorageWorks  recommends  running  the  burninErrClear  command  prior  to  running 

diagSetBurnin  and  diagSetCycle. 


Operands 

This  command  has  the  following  operands: 

--slot  slotnumber  Specify  which  slot  number  to  update.  If  this  option  is  not 

specified  at  all,  then  all  slots  on  the  switch  are  set  up  for  burn-in. 

script  Specify  the  name  of  the  burn-in  script  to  run. 

-current  Set  the  name  of  burn-in  script  to  current  burn-in  script. 

Examples 

To  set  the  burn-in  script  and  mode: 

switch : admin>  diagsetburnin  --slot  1  -current 
existing  script  is:  /fabos/share/switchess . sh 
Burnin  mode  is  Enabled. 

Removing  all  log  files  in  /var/log  for  slot  1 

Slot  1  burnin  name  is  now  /fabos/share/switchess . sh 

Config  update  Succeeded 

See  also 

burninErrShow 
diagSetCycle 
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diagSetCycle 


Sets  diagnostic  script  parameters. 

Synopsis 

diagsetcycle  script   [-show   |    -default    |    [-keyword  value]] 

Availability 

admin 

Description 

Use  this  command  to  provide  an  interactive  method  to  update  diagnostic  command  parameters.  If  only 
script  is  specified,  the  command  displays  all  configuration  variables  used  by  the  specified  script  and  enters 
an  interactive  session.  If  all  parameters  are  used,  variables  can  be  updated  manually. 

In  interactive  mode,  the  current  value,  default  value,  and  description  of  purpose  of  the  variable  are 
displayed  for  each  variable.  If  no  new  value  is  specified,  the  current  value  is  left  unchanged.  If  a  new 
value  is  entered,  its  value  is  updated  and  stored  in  the  configuration  database  for  that  blade  type.  This 
command  does  not  require  a  reboot  to  take  effect. 


NOTE:    HP  StorageWorks  recommends  running  the  burninErrClear  command  prior  to  running 

C— I    diagSetBurnin  and  diagSetCycle. 


Operands 

This  command  has  the  following  operands: 

script  Specify  a  script  in  which  you  want  to  change  parameters. 

-show  Specify  this  operand  to  display  the  parameters  for  the  specified 

diagnostic  script. 

-default  Specify  this  operand  to  set  the  script  parameters  to  default 

values. 

-keyword  value  The  script  parameters  can  be  updated  noninteractively  using  this 

style  of  option  list,  value  is  the  keyword  to  update;  the  value 
should  be  specified  manually  in  this  case. 
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Examples 

To  update  diagnostic  command  parameters: 


switch: 

admin>  diagsetcycle 

switchburnin . sh  -show 

CURRENT 

-  KEYWORD  : 

DEFAULT 

1 

-  number_of _runs  : 

1 

2 

-  vib  : 

2 

10 

-  thermal  : 

10 

BURNIN 

-  label  : 

BURNIN 

1 

-  tbr_passes  : 

1 

1 

-  prt_on  : 

1 

1 

-  cntmem_on  : 

1 

1 

-  cmi_on  : 

1 

1 

-  retention_on  : 

1 

1 

-  cam_on  : 

1 

50 

-  flt_passes  : 

50 

25 

-  sta_passes  : 

25 

100 

-  plb_nframes  : 

100 

50 

-  txd_nframes  : 

50 

200 

-  xpt  nframes  : 

200 

20 

-  bpt_nframes  : 

20 

50 

-  slk_nmegs  : 

50 

30 

-  bpt_all_nf rames : 

30 

50 

-  slk_all_nmegs  : 

50 

See  also 

burninLevel 

diagSetBurnin 

diagStopBurnin 


Fabric  OS  5.x  command  reference  guide   1 55 


diagSetEsdMode 


Enables  or  disables  ESD  mode. 

Synopsis 

diagsetcycle  script   [-show   |    -default    |    [-keyword  value]] 
setesdmode   [mode   \  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  ESD  mode.  The  mode  is  saved  in  flash  memory  and  stays  in  that 
mode  until  the  next  execution  of  setEsdMode.  The  mode  becomes  active  as  soon  as  this  command  is 
executed.  It  does  not  require  a  reboot  to  take  effect. 

ESD  mode  modifies  the  behavior  of  the  diagnostic  test  methods  and  post  scripts.   The  exact  behavior 
varies  but  most  commonly  consists  of  disabling  the  ports  defined  when  spinSilk  or  other  functional  tests 
are  run  for  ESD  or  EMI  testing  purposes. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  ESD  mode.  This 

operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This 

operand  is  optional.  If  no  operand  is  specified,  the  current  value 
displays. 

Examples 

switch : admin>  setesdmode  -show 

Esd  Mode  is  0    (Disabled) . 

See  also 

spinSilk 
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diagShow 

Displays  diagnostics  status. 

Synopsis 

diagshow  [--slot  number]  [-uports  itemlist]  [-bports  itemlist]  [-use_bports 
value] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  diagnostics  status  for  the  specified  list  of  blade  or  user  ports. 

Operands 

This  command  has  the  following  operands: 

-slot  number  Specify  which  slot  to  operate  on.  If  this  option  is  not  specified, 

the  default  slot  0  is  used.  The  default  slot  is  designed  to  operate 
on  fixed-port-count  products.  By  default,  this  command  displays 
all  user  ports  in  the  system. 

-uports  itemlist       Specify  a  list  of  user  ports  to  display.  This  operand  is  optional. 

-bports  itemlist       Specify  a  list  of  blade  ports  to  display.  This  operand  is  optional. 

-use_bports  value     If  this  value  is  not  0  the  diagnostics  status  for  the  blade  ports 

specified  in  -use_bports  displays;  otherwise,  the  user  ports 
specified  in  -uports  displays.  The  default  value  is  0.  This 
operand  is  optional. 

Examples 

To  display  diagnostic  status  on  a  switch  blade: 

switch : admin>  diagshow 

Diagnostics  Status:     Fri  Feb  08  15:25:24  2002 


Slot: 

1  UPORTS 

Port 

BPort 

Diag 

Active 

Speed 

0 

15 

OK 

UP 

2G 

Auto 

1 

14 

OK 

UP 

2G 

Auto 

2 

13 

OK 

UP 

2G 

Auto 

3 

12 

OK 

UP 

2G 

Auto 

4 

31 

OK 

UP 

2G 

Auto 

5 

30 

OK 

UP 

2G 

Auto 

6 

29 

OK 

UP 

2G 

Auto 

7 

28 

OK 

UP 

2G 

Auto 

8 

47 

OK 

UP 

2G 

AutO 

(output  truncated) 


See  also 


itemList 
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diagShowTime 

Sets  or  displays  diagnostic  show-time  mode. 

Synopsis 

diagshowtime   [mode   |  -show] 

Availability 

admin 


Description 

Use  this  command  to  enable  show-time  mode  (if  the  mode  value  is  not  0)  or  disable  the  show-time  mode 
(if  the  mode  value  is  set  to  0).  The  mode  is  saved  in  flash  memory  (and  stays  in  that  mode)  until  the  next 
execution  of  diagShowTime.  The  mode  becomes  active  as  soon  as  this  command  is  executed;  it  does 
not  require  a  reboot  to  take  effect. 

Show-time  mode,  when  enabled,  causes  each  test  to  display  elapsed-time  messages.  It  is  normally  used 
during  burn-in  and  for  test  method  debugging. 


NOTE:    diagsetshowtime  is  an  alias  of  diagshowtime. 


Operands 

This  command  has  the  following  optional  operands: 

mode  Specify  1  (or  any  nonzero  value)  to  enable  show-time  mode; 

specify  0  to  disable  show-time  mode. 

-show  Specify  this  operand  to  display  the  current  mode  setting. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  enable  show-time  mode: 

switch : admin>  diagshowtime 

Show  Time  mode  is  0   (Disabled) . 

switch : admin>  diagshowtime  1 

Config  update  Succeeded 

Show  Time  mode  is  now  1    (Enabled) . 
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diagSkipTests 

Enables  or  disables  diagnostics  skip  test  flags. 

Synopsis 

diagskiptests    [value  |  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  the  diagnostics  skip  test  flags.  The  skip  test  flags  are  saved  in 
flash  memory  and  stay  set  until  the  next  execution  of  diagSkipTests. 

The  mode  becomes  active  as  soon  as  this  command  is  executed.  It  does  not  require  a  reboot  to  take 
effect. 

The  skip  test  flags  are  used  to  skip  the  execution  of  certain  POSTs  that  might  prove  hazardous  to  normal 
switch  operation.  The  exact  use  of  this  flag  is  determined  by  the  POST  scripts  and  the  specific  test 
methods  used. 

Operands 

This  command  has  the  following  operands: 

value  Specify  a  bit  mask  for  tests  to  skip. 

-show  If  specified  or  no  value  is  given,  the  current  skip  test  flags 

displays. 

If  no  operand  is  specified,  the  current  value  is  displayed. 

Examples 

To  display  the  current  skip  test  flags: 

switch :admin>  diagskiptests  -show 
Skip  tests  is  1. 
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diagStatus 

Displays  currently  running  diagnostic  tests. 

Synopsis 

diagstatus    [  slotnumber  ] 

Availability 

all  users 

Description 

Use  this  command  to  display  currently  running  diagnostic  test  names. 

Operands 

This  command  has  the  following  optional  operand: 

slotnumber  Specifies  the  slot  to  display.  If  omitted,  all  blades  in  the  system 

are  assumed. 

Examples 

To  display  currently  running  diagnostic  tests: 


switch: admin>  diagstatus 

Diagnostic  status  for  slot: 
Diag  executing  "NONE" 

1 . 

Diagnostic  status  for  slot: 
Diag  executing  "NONE" 

2  . 

Diagnostic  status  for  slot: 
Diag  executing  "NONE" 

3  . 

Diagnostic  status  for  slot: 
Diag  executing  "NONE" 
(output  truncated) 

4  . 
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diagStopBurnin 

Terminates  a  blade  burn-in  run. 

Synopsis 

diagstopburnin   [--slot  number] 

Availability 

admin 

Description 

Use  this  command  to  determine  which  PID  is  running  burn-in  on  a  blade  and  terminate  that  activity.  The 
burn-in  script  handles  the  logging  cleanup. 

This  command  does  not  require  a  reboot  to  take  effect. 
Operands 

This  command  has  the  following  optional  operand: 

--slot  number  Specify  the  slot  to  stop  burn-in.  If  no  slot  is  specified,  this 

command  executes  on  all  slots  in  the  logical  switch.  This 
operand  is  optional. 

Examples 

To  stop  burn-in  mode  on  a  switch: 


switch : admin>  diagstopburnin  --slot 

1 

No  burn-in  script  active  on  slot  1 

1  burninErrShow  output : 

Oxleea  (fabos):  Dec  19  14:42:18 

Switch:    0,    Error  DIAG-MANUAL1 ,    I,  " 

1 

Starting 

switchess  . . . 

Err#   0140042  0100:101:000:001:24:37 

0xc84    (fabos):   Dec  20  08:57:27 

Switch:    0,    Error  DIAG-MANUAL1 ,    1,  " 

1 

switchess 

:  ABORT 

Err#   0140042  0100:101:000:000:25:41 

0xlb61    (fabos):   Feb  07  19:02:28 

Switch:    0,    Error  DIAG-MANUAL1 ,    1,  " 

1 

Starting 

switchess  . . . 

Err#   0140042  0100:101:000:001:26:39 

0x47ff   (fabos):   Feb  07  21:45:36 

Switch:    0,    Error  DIAG-MANUAL1 ,    1,  " 

1 

switchess 

:  ABORT 

Err#   0140042  0100:101:000:002:26:41 

IN 

See  also 

diagSetBurnin 
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dlsReset 

Disables  the  dynamic  load  sharing  (DLS)  option. 

Synopsis 

dlsreset 

Availability 

admin 

Description 

Use  this  command  to  turn  off  DLS  when  a  fabric  change  occurs.  See  dlsSet  for  a  full  description  of  load 
sharing. 


r2^f  NOTE:  This  command  should  be  used  only  if  devices  connected  to  the  fabric  cannot  handle  occasional 
t— I    routing  changes  correctly. 

DLS  is  not  supported  in  certain  routing  policies.  See  aptPolicy  for  more  information  on  routing 
policies. 


Operands 

none 

Examples 

To  disable  the  dynamic  load  sharing  option: 


See  also 


switch: admin>  dlsreset 

Committing  configuration. 

. done . 

switch : admin>  dlsshow 

DLS  is  not  set 

aptPolicy 

dlsSet 

dlsShow 
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dlsSet 

Enables  the  dynamic  load  sharing  (DLS)  option. 

Synopsis 

dlsset 

Availability 

admin 

Description 

Use  this  command  to  turn  on  DLS  when  a  fabric  change  occurs. 

Routing  is  generally  based  on  the  incoming  port  and  the  destination  domain.  This  means  that  all  the 
traffic  coming  in  from  a  port  (either  an  E_Port  or  an  Fx_Port)  directed  to  the  same  remote  domain  is  routed 
through  the  same  output  E_Port. 

To  optimize  fabric  routing,  when  there  are  multiple  equivalent  paths  to  a  remote  switch,  traffic  is  shared 
among  all  the  paths.  Load  sharing  is  recomputed  when  a  switch  is  booted  up  or  every  time  a  change  in 
the  fabric  occurs.  A  change  in  the  fabric  is  defined  as  an  E  Port  going  up  or  down  or  an  Fx  Port  going 
up  or  down. 

During  load  sharing,  recomputation,  existing  routes  might  be  moved  to  maintain  optimal  balance.  This 
can  cause  momentary  frame  loss  along  these  routes. 

In  contrast,  if  DLS  is  turned  off  (using  dlsReset),  load  sharing  calculations  are  used  only  to  place  new 
routes.  Once  placed,  existing  routes  are  never  moved  from  one  output  E_Port  to  another  unless  the 
original  output  E_Port  is  no  longer  a  recognized  path  to  the  remote  domain.  Optimal  balance  is  rarely 
achieved  with  this  setting. 


NOTE:    DLS  is  not  supported  in  certain  routing  policies.  See  aptPolicy  for  more  information  on  routing 
t— I  policies. 


Operands 

none 

Examples 

To  enable  the  dynamic  load  sharing  option: 


switch 

admin> 

dlsset 

switch 

admin> 

dlsshow 

DLS  is 

set 

See  also 

aptPolicy 

dlsReset 

dlsShow 

iodReset 

iodSet 

iodShow 

uRouteShow 

topologyShow 
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dlsShow 

Display  the  setting  of  the  dynamic  load  sharing  (DLS)  option. 

Synopsis 

dlsshow 

Availability 

all  users 

Description 

Use  this  command  to  display  whether  DLS  is  on  or  off.  One  of  two  messages  displays: 

DLS  is  set  The  DLS  option  is  turned  on.  Load  sharing  is  reconfigured  with 

every  change  in  the  fabric,  and  existing  routes  can  be  moved  to 
maintain  optimal  balance. 

DLS  is  not  set  The  DLS  option  is  turned  off.  Once  placed,  existing  routes  are 

never  moved  to  maintain  optimal  balance. 

See  dlsSet  for  a  description  of  load  sharing. 

Operands 

none 

Examples 

To  display  the  current  DLS  option  setting: 

switch : admin>  dlsshow 
DLS  is  set 


See  also 

dlsSet 
dlsReset 
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dnsConfig 

Sets  or  displays  domain  name  service  (DNS)  parameters. 

Synopsis 

dnsconf ig 

Availability 

admin 

Description 

Use  this  command  to  display  or  set  the  DNS  parameters. 

The  domain  name  service  parameters  are  the  domain  name  and  the  name  server  IP  address  for  primary 
and  secondary  name  servers. 

Operands 

none 

Examples 

To  set  the  DNS  parameters  for  the  system: 


switch : admin>  dnsconf ig 

Enter  option 

1  Display  Domain  Name  Service  (DNS) 

configuration 

2  Set  DNS  configuration 

3  Remove  DNS  configuration 

4  Quit 

Select  an  item:    (1..4)    [4]  2 

Enter  Domain  Name :    [ ]   domain . com 

Enter  Name  Server  IP  address  in  dot 

notation:    []  123 

123 

123 

123 

Enter  Name  Server  IP  address  in  dot 

notation:    []  123 

123 

123 

124 

DNS  parameters  saved  successfully 

Enter  option 

1  Display  Domain  Name  Service  (DNS) 

configuration 

2  Set  DNS  configuration 

3  Remove  DNS  configuration 

4  Quit 

Select  an  item:    (1..4)    [4]  4 
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See  also 

conf igDownload 

conf igUpload 

f irmwareDownload 

ipAddrSet 

ipAddrShow 
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enclosureShow 


Displays  attributes  of  the  switch  enclosure. 


Synopsis 

enclosureShow  attribute 

Availability 

all  users 

Description 


Use  this  command  to  display  attributes  of  the  switch  enclosure.  Currently,  supported  attributes  are  the 
vendor-specific  enclosure  identifier  and  the  identifier  of  the  enclosure  interface  to  which  the  switch  is 
attached. 


Operands 

This  command  has  the  following  operands: 


Examples 

To  display  the  identifier  of  the  enclosure  interface  to  which  the  switch  is  attached: 


switch : admin>  enclosureShow  slotid 

Bay  4 


attribute 


modelname 


slotid 


id 


Attribute  of  the  enclosure  to  display: 

Displays  the  vendor-specific  enclosure  identifier. 

Displays  the  vendor-specific  enclosure  model  name. 

Displays  the  identifier  of  the  enclosure  interface  to 
which  the  switch  is  attached. 


See  also 


none 
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errClear 

Clears  all  error  log  messages  for  all  switch  instances  on  this  control  processor  (CP). 

Synopsis 

errclear 

Availability 

admin 

Description 

Use  this  command  to  clear  all  internal  and  external  error  log  messages  for  all  switch  instances  on  this  CP. 

Operands 

none 

Examples 

To  clear  the  error  log  messages: 

switch : admin>  errclear 

See  also 

err Dump 
errShow 
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errDelimiterSet 

Sets  the  error  log  start  and  end  delimiter  for  messages  sent  to  the  console  and  syslog. 

Synopsis 

errdelimiterset   [-s  " start_delimiter_string"  ]    [-e  " end_delimiter_string"  ] 

Availability 

admin 

Description 

Use  this  command  to  set  the  error  log  start  and  end  delimiter  for  log  messages  sent  to  the  console  and 
syslog.  An  empty  string  clears  the  start  and  the  end  delimiters  (including  the  colon)  so  that  they  are  not 
displayed. 

If  no  arguments  are  supplied  to  the  command,  it  instead  displays  the  existing  errDelimiterSet 
configuration.  These  delimiters  are  stored  persistently. 

Operands 

This  command  has  the  following  optional  operands: 

-s  start_delimi  ter_string        Specifies  the  alphanumeric  string  for  the  start  delimiter; 

up  to  1 0  characters  are  allowed. 

-e  end_delimiter_string  Specifies  the  alphanumeric  string  for  the  end  delimiter; 

up  to  10  characters  are  allowed. 

Examples 

To  display  the  start  and  end  delimiter: 

switch : admin>  errdelimiterset 
delimiter  start  string:  <none> 
delimiter  end  string:  <none> 
To  change  the  start  and  end  delimiter  (with  sample  output): 

switch : admin>  errdelimiterset  -s  "Start"   -e  "End" 

Start:2003/03/10-09:54:03,    [NS-1002],    1035,,    ERROR,    SWITCH43 ,  Name 
Server  received  an  invalid  request  from  device  10 : 02 : 32 : A3 : 78 : 23 : 23 : End 

See  also 

err Dump 

errFilterSet 

errShow 
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err  Dump 


Displays  the  error  log,  without  pagination. 


Synopsis 


errdump    [-s  switch_instance]  [-r] 


Availability 

all  users 

Description 

Use  this  command  to  display  external  error  log  messages  for  all  switch  instances  and  the  chassis,  without 
pagination.  The  -r  operand  displays  the  messages  in  reversed  order.  The  following  information  displays 
in  each  message: 


Start  delimiter 
Timestamp 
Message  ID 

External  sequence  number 
Security  audit  flag 
Severity 

Switch  name 
Message 
End  delimiter 


Delimiter  string  for  the  start  of  a  message. 

Timestamp  for  the  message. 

Message  identifier. 

Sequence  number  for  the  message 

Security  audit  logged.  AUDIT  displays  in  the  field. 

Severity  of  the  message.  Valid  values  include  INFO,  WARNING, 
ERROR,  and  CRITICAL. 

Switch  name  for  the  generator  of  this  message,  or  "chassis". 
Message  body. 

Delimiter  string  for  the  end  of  a  message. 


Operands 


This  command  has  the  following  optional  operands: 

-s  switch  instance 


Specifies  to  display  messages  only  from  one  switch  instance.  Valid 
values  are  0  or  1.  If  this  option  is  omitted,  messages  from  all 
switch  instances  are  displayed. 

Specifies  to  display  messages  in  reversed  order.  If  this  option  is 
omitted,  the  messages  display  in  the  normal  order. 


Examples 


To  display  the  error  log,  without  pagination: 


switch: user >  errdump 

Version:  4.4.0 

2004/07/14-22:24:08,  [HAMK-1003] 

1, 

INFO, 

switchl,  Heartbeat  up 

2004/07/14-22:24:47,  [FSSM-1002] 

2, 

INFO, 

switchChassis ,  HA 

State  is  in  sync 

2004/07/14-22:25:29,  [SEC-1192], 

3,  , 

INFO, 

switch2,  Security 

violation:   Login  failure  attempt 

via 

SERIAL 

1 70   Fabric  OS  commands 


See  also 

errDelimiterSet 

errFilterSet 

errShow 
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errFilterSet 

Sets  a  filter  for  an  error  log  destination. 

Synopsis 

errFilterSet   [-d  "destination"  ]  [-v  "severity"  ] 

Availability 

admin 

Description 

Use  this  command  to  set  a  filter  for  an  error  log  destination.  A  filter  is  set  based  on  the  severity  level  of  the 
messages. 

If  no  parameters  are  specified,  this  command  displays  the  filters  that  are  currently  in  use. 

Operands 

This  command  has  the  following  operands: 

-d  "destination"         Specifies  the  destination  to  set  the  filter.  The  "console"  string  is 

the  only  valid  value  at  this  time. 

-v  "severity"  Specifies  the  minimum  severity  of  the  message  to  pass  through 

the  filter.  Valid  values  are  "info",  "warning",  "error",  and 
"critical". 

Examples 

To  display  the  current  filter  settings: 

switch : admin>  errfilterset 
console:   filter  severity  =  WARNING 
To  set  the  filter  severity  level  for  the  console: 

switch: admin>  errfilterset  -d  "console"   -v  "WARNING" 

See  also 

err Dump 
errModuleShow 
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errModuleShow 

Displays  all  the  defined  error  log  modules. 

Synopsis 

errmoduleshow 

Availability 

user 

Description 

Use  this  command  to  display  a  list  of  all  defined  error  log  modules. 

Operands 

none 
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Examples 

To  display  a  list  of  all  defined  error  log  modules: 
switch: user >  errmoduleshow 

KT 

UT 

TRCE 

KTRC 

LOG 

CDR 

BLPU 

PISP 

PIXE 

EGR 

BL 

PIC 

PS 

RTE 

AS 

AUTH 

BLDE 

BLM 

BPRT 

CER 

CFLD 

CFMN 

CHPS 

CONF 

CPT 

DIAG 

EM 

ERRL 

FABR 

FABS 

FCIU 

FCMC 

FCPD 

FCPH 

FICU 

FILB 

FKLB 

(output  truncated) 

See  also 

err Dump 
errShow 
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errShow 

Displays  the  error  log  messages,  with  pagination. 

Synopsis 

errshow   [-s  switch_instance]  [-r] 

Availability 

all  users 

Description 

Use  this  command  to  display  external  error  log  messages  for  all  switch  instances  and  the  chassis,  one  at 
a  time.  The  -r  operand  displays  the  messages  in  a  reversed  order.  The  following  information  displays  in 
each  message: 


Start  delimiter 

Delimiter  string  for  the  start  of  a  message. 

Timestamp 

Timestamp  for  the  message. 

Message  ID 

Message  identifier. 

External  sequence 

Sequence  number  for  the  message 

number 

Security  audit  flag 

Security  audit  logged.  AUDIT  displays  in  the  field. 

Severity 

Severity  of  the  message.  Valid  values  include  INFO,  WARNING, 

ERROR,  and  CRITICAL. 

Switch  name 

Switch  name  for  the  generator  of  this  message,  or  "chassis". 

Message 

Message  body. 

End  delimiter 

Delimiter  string  for  the  end  of  a  message. 

Operands 

This  command  has  the  following  optional  operands: 

-s  Specifies  to  display  messages  only  from  one  switch  instance. 

Valid  values  are  0  or  1 .  If  this  operand  is  omitted,  messages 
from  all  switch  instances  are  displayed. 

-r  Specifies  to  display  messages  in  reversed  order.  If  this  operand 

is  omitted,  the  messages  display  in  the  normal  order. 
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Examples 

To  display  the  error  log,  with  pagination: 


switch :user>  errshow 
Version:  4.4.0 

2004/07/14-22:24:08,    [HAMK-1003],  1, 

Type  <CR>  to  continue,   Q<CR>  to  stop 

2004/07/14-22:24:47,  [FSSM-1002],  2, 
in  sync 

Type  <CR>  to  continue,   Q<CR>  to  stop 

2004/07/14-22:25:29,  [SEC-1192],  3,, 
Login  failure  attempt  via  SERIAL. 

Type  <CR>  to  continue,   Q<CR>  to  stop 


INFO,    switchl,   Heartbeat  up 


INFO,   switchChassis ,   HA  State  is 


INFO,   switch2 ,  Security  violation: 


See  also 

errDelimiterSet 
err Dump 
errFilterSet 
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exit 

Logs  out  from  a  shell  session. 

Synopsis 

exit 

Availability 

all  users 

Description 

Use  this  command  to  log  out  from  a  telnet,  rlogin  or  serial  port  session.  Telnet  and  rlogin  connections  are 
closed;  the  serial  port  returns  to  the  login:  prompt. 

The  exit  command  is  an  accepted  synonym  for  logout,  as  is  pressing  Ctrl-D  at  the  beginning  of  a  line. 
Operands 

none 

Examples 

To  exit  from  a  shell  session: 

switch : admin>  exit 
Connection  to  host  lost. 


See  also 

logout 
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fabPortShow 


Displays  fabric  port  information. 


Synopsis 

f abportshow   [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  state  of  a  port,  relative  to  the  fabric,  as  well  as  a  list  of  pending 
commands.  The  following  information  displays: 


Port 


Displays  the  port  number. 


State 


The  state  of  the  port: 


PO  Port  Offline 

PI  Port  Online 

P2  ELP  ACC  Received 

P3  Link  Reset  Done 

10  Trunk  Initiator:  EMT  Sent 

11  Trunk  Initiator:  ETP  ACC  Received 

12  Trunk  Initiator:  ETP  Sent 

13  Trunk  Initiator:  Link  Reset 
TO  Trunk  Target:  EMT  Received 
Tl  Trunk  Target:  ETP  Received 
T2  Trunk  Target:  Link  Reset 

LD  Dynamic  long  distance:  ECP  sent  or  received 

T3  Trunk  Target:  Link  reset  done  on  slave 

14  Trunk  Initiator:  Link  reset  done  on  slave 


List 


IU  list  pointer 
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Flags 


Port  flags: 


0x00000001 

0x00000002 

0x00000004 

0x00000008 

0x00000010 

0x00000020 

0x00000040 

0x00000080 

0x00000200 

0x00000800 

0x00001000 

0x00002000 

0x00004000 

0x00008000 

0x00010000 

0x00020000 

0x00040000 

0x00080000 

0x00100000 

0x00200000 

0x00400000 

0x00800000 

0x01000000 

0x02000000 

0x040000000 

0x080000000 

0x100000000 

0x200000000 


Slave  connection 

Loopback  connection 

Incompatible  connection 

Overlapping  domains 

Overlapping  zones 

Done  PTIO  ioctl 

Sent  an  RJT  to  ELP 

BF  received  from  the  port 

Segmented  by  routing  code 

Zoning  has  completed 

Segmented  by  Platform  Management 

Segmented  due  to  no  license 

Segmented  due  to  E_Port  disabling 

DIA  already  sent  for  that  port 

RDI  already  sent 

Port  is  true  T  port 

Port  received  an  ELP 

Port  received  an  ELP  RJT 

LR  pending  due  to  ELP  RJT  rev 

Received  a  DIA  on  this  port 

Port  is  the  EMT  Initiator 

Security  violation 

Security  incompatibility 

Rev  a  DIA  ACC 

Port  is  security  authenticating 

ECP  RJT  or  retires  exceeded 

Segmented  due  to  duplicated  WWN 

Segmented  due  to  E  Port  isolation 


nbrWWN       Neighboring  switch's  WWN 


nbrPort  Neighboring  switch's  port 


Ir  tid  Link  reset  timer  identifier  and  current  state. 


red_ports        All  E_Ports  that  are  connected  to  the  same  neighboring  switch 


Operands 


This  command  has  the  following  operands: 

slotnumber 


portnumber 


For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to 
display,  followed  by  a  slash  (/). 

Specifies  the  port  number  to  display,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  to  list  valid  ports. 
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Examples 

To  display  fabric  port  information: 


switch : admin>  fabportshow  4/14 
Fabric  Port  Information: 


Port:  62 

State:  P3 

List:  0x10068418 

List  Count:  0 

Flags:  0x280120 

nbrWWN:  10 : 00 : 00 : 60 : 69 : 80 : 06 : cf 

red__ports  : 
10  11  62  63 

Open  commands  pending: 
No  commands  pending 


See  also 

portShow 
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fabRetryShow 

Displays  the  retry  count  of  the  fabric  commands. 

Synopsis 

f abretryshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  retry  count  of  the  fabric  commands.  The  SWJSL  (ISL  ports)  information 
displays  the  retry  count  for  the  following  fabric  commands: 


ELP  Exchange  Link  Parameters 

ELP  Exchange  Link  Parameters 

HA  EFP  Exchange  Fabric  Parameters 

DIA  Domain  Identifier  Assigned 

RDI  Request  Domain  Identifier 

BF  Build  Fabric 

RSCN  Remote  State  Change  Notification 

FWD  Fabric  Controller  Forward 

EMT  Fabric  Controller  Mark  Timestamp 

ETP  Fabric  Controller  Trunk  Parameters 

RAID  Return  Address  Identifier 

GAID  Get  Address  Identifier 

INQ  Inquiry  Command 

ELP_TMR  Used  internally  for  fabric  application  (not  a  SWJSL) 

GRE  Get  Route  Entry 

ECP  Exchange  Credit  Parameters 

FWN  Firmware  Notification 


Operands 

none 
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Examples 

To  display  the  retry  count  of  Fabric  OS  commands: 


switch :user> 

f abretryshow 

E_Ports 

SW_ISL 

21 

31 

40 

44 

ELP 

0 

0 

0 

0 

EFP 

0 

1 

0 

0 

HA_EFP 

0 

0 

0 

0 

DIA 

0 

0 

0 

0 

RDI 

0 

0 

0 

0 

BF 

0 

0 

0 

0 

RSCN 

0 

0 

0 

0 

FWD 

0 

0 

0 

0 

EMT 

0 

0 

0 

0 

ETP 

0 

0 

0 

0 

RAID 

0 

0 

0 

0 

GAID 

0 

0 

0 

0 

INQ 

0 

0 

0 

0 

ELP_TMR 

0 

0 

0 

0 

GRE 

0 

0 

0 

0 

ECP 

0 

0 

0 

0 

FWN 

0 

0 

0 

0 

See  also 

f abStatsShow 
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fabricLog 


Displays  (all  users)  or  manipulates  (admin)  the  fabric  log. 


Synopsis 

fabricLog  -s  \    -c  \    -d  |    -e  |    -r  size 

Availability 

all  users 
admin 

Description 

Use  this  command  to  display,  clear,  disable,  enable,  or  resize  the  fabric  log. 

Operands 

This  command  has  the  following  operands: 


-r  size 


--resize  size 


s  I 
c  I 

a  I 

e  I 


enable 


disable 


show 


clear 


I 


Displays  fabric  log  (all  users). 
Clears  fabric  log. 

Disables  fabric  log.  By  default,  the  fabric  log  is  enabled. 
Enables  fabric  log. 

Changes  the  maximum  number  of  log  entries.  The  given  size 
has  to  be  at  least  2  and  a  power  of  2;  otherwise,  the  command 


fails. 
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Examples 

To  change  the  number  of  entries: 


switch :admin>  fabriclog  -s 

Time 
Xid 

Stamp 

Input  and  *Action 

O  ,     Jr         on ,  Jrn 

rorc 

11955 

:  655 

SCN  Switch  Online 

F2  ,  NA     F2  ,NA  NA 

NA 

11955 

:  657 

*Start  2  *  F_S_TOV  Timer 

F2,NA    F2,NA  NA 

NA 

11955 

:  657 

*  Start  60  *  F_S_TOV  Timer 

F2  ,  NA    F2  ,  NA  NA 

NA 

11955 

:  669 

RSCN  Rev  addr:  0x3  000000 

F2  ,  NA    F2  ,  NA  NA 

NA 

11957 

:  65 

SCN  Port  Online 

Jr  /  ;  r  U       JTZ/Jr-L  /I 

TvTfl 
l\l.fi 

11957 
0x277 

:  69 

*ELP  Send 

F2,P1  F2,P1 

21 

11957 

:  69 

SCN  Port  Online 

F2,P0     F2,P1  44 

NA 

1  1  OCT 

0x279 

•  7  R 

JiljJr  OGllO. 

F2,P1  F2,P1 

44 

I  1  OCT 

II  J  J  / 

0x277 

■  77 

J2jlj.tr    r\.fci  C  c:  -L  V  fcJ 

F2,P1  F2,P1 

44 

1  1  OCT 

0x277 

•  7  B 

.  /  o 

JliJ_f  Jr     oeriCLlily  riL-1^ 

F2,P1  F2,P2 

44 

11957 
0x2  7  9 

:  82 

ELP  Receive 

F2,P1  F2,P1 

21 

11957 
0x2  7  9 

:  83 

*ELP  Sending  ACC 

F2,P1  F2,P2 

21 

11957 
0x2  7  7 

:  87 

ELP  ACC  Receive 

F2  ,  P2     F2 , P2 

21 

switch : admin>  fabriclog  -r  64 

Warning:  This  command  will  clear  the  logs. 

Are  your  sure  you  want  to  do  the  resize  [y/n] 

?  Y 

switch :admin>  fabriclog  -s 

Time 
Xid 

Stamp 

Input  and  * Ac t i on 

S ,   P      Sn , Pn 

Port 

See  also 

f abPortShow 
f abStatsShow 
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fabricPrincipal 

Sets  principal  switch  selection  mode. 

Synopsis 

f abricprincipal    [-fhq] [  mode  ] 

Availability 

all  users  (display  current  setting) 

admin  (modify  current  setting) 
Description 

Use  this  command  to  set  principal  switch  selection  mode  for  the  switch. 

The  implementation  of  the  fabricPrincipal  command  is  based  solely  on  mechanisms  specified  in  the 
Fibre  Channel  standards.  These  mechanisms  provide  a  preference  for  a  switch  requesting  to  be  the 
principal  switch  in  a  fabric,  but  they  do  not  provide  an  absolute  guarantee  that  a  switch  requesting  to  be 
the  principal  switch  will  actually  achieve  this  status. 

When  dealing  with  larger  fabrics,  the  selection  of  the  principal  switch  is  less  deterministic.  In  these  cases, 
to  help  ensure  that  the  desired  switch  is  selected  as  the  principal  switch,  a  small  selection  of  switches 
should  be  connected  together  first,  followed  by  the  addition  of  the  rest  of  the  fabric. 

Operands 

This  command  has  the  following  operands: 

-f  Specify  the  -f  option  to  force  a  fabric  rebuild.  This  option  is 

required  when  enabling  principal  switch  mode.  This  option  is 
not  valid  when  disabling  principal  switch  mode. 

-h  Specify  the  -h  option  to  display  command  usage  summary. 

-q  Specify  the  -q  option  to  display  the  current  mode  state. 

mode  Specify  1  to  enable,  or  0  to  disable  principal  switch  mode  (the 

mode  activates  when  the  fabric  rebuilds).  This  operand  is 
optional. 

Examples 

To  display  the  current  mode  setting: 

switch : admin>  f abricprincipal  -q 
Principal  Selection  Mode:  Enable 

To  disable  the  principal  selection  mode  setting: 

switch : admin>  f abricprincipal  0 
Principal  Selection  Mode  disabled 

To  enable  the  principal  selection  mode  setting: 

switch : admin>  f abricprincipal  1 
Principal  Selection  Mode  enabled 
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To  enable  the  principal  selection  mode  setting  and  force  fabric  rebuild: 

switch : admin>  f abricprincipal  -f  1 

Principal  Selection  Mode  enabled  (Forcing  fabric  rebuild) 

See  also 

f abricShow 
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fabricShow 

Displays  fabric  membership  information. 

Synopsis 

f abricshow 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  switches  in  the  fabric. 

If  the  switch  is  initializing  or  disabled,  the  message  no  fabric  is  displayed.  If  the  fabric  is 
reconfiguring,  some  or  all  switches  might  not  display;  otherwise,  the  following  fields  display: 

Switch  ID  The  switch  DomainJD  and  embedded  port  D  ID 

world  wide  name  The  switch  WWN 

Enet  IP  Addr  The  switch  Ethernet  IP  address 

FC  IP  Addr  The  switch  FC  IP  address 

Name  The  switch  symbolic  name.  An  arrow  (>)  indicates  the  principal 

switch. 


Operands 

none 

Examples 

The  following  example  illustrates  a  fabric  of  four  switches.  "swl80"  is  the  principal  switch.  Three  of  the 
switches  are  configured  to  run  IP  over  Fibre  Channel. 

switch : admin>  f abricshow 

Switch  ID      Worldwide  Name  Enet  IP  Addr        FC  IP  Addr  Name 


64: 

f f fc40 

10 

00 

00 

60 

69 

00 

06 

56 

192 

168 

64 

59 

192 

168 

65 

59 

"  sw5 " 

65  : 

f ffc41 

10 

00 

00 

60 

69 

00 

02 

0b 

192 

168 

64 

180 

192 

168 

65 

180 

>" swl80 

66  : 

f ffc42 

10 

00 

00 

60 

69 

00 

05 

91 

192 

168 

64 

60 

192 

168 

65 

60 

" sw60 " 

67  : 

f ffc43 

10 

00 

00 

60 

69 

10 

60 

If 

192 

168 

64 

187 

0.0 

0.0 

" swl87 

The  Fabric  has  4  switches 


See  also 

switchShow 
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fabStateClear 

Clears  the  fabric  state  information. 

Synopsis 

f abs tat eel ear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  queue  of  fabric  state  information  logged  by  the  fabric. 


[2^f  NOTE:    This  command  is  obsoleted  by  f  abricLog  -c. 


Operands 

none 

Examples 

To  clear  the  fabric  state  information: 


switch : admin>  fabstateshow 
Time  Stamp     Input  and  *Action 

S,  P 

Sn,  Pn 

Port 

Xid 

11955 

:  655 

SCN  Switch  Online 

F2  ,NA 

F2,NA 

NA 

NA 

11955 

:  657 

* Start  2  *  F_S_TOV  Timer 

F2  ,  NA 

F2  ,  NA 

NA 

NA 

11955 

:  657 

* Start  60  *  F_S_T0V  Timer 

F2  ,  NA 

F2  ,  NA 

NA 

NA 

11955 

:  669 

RSCN  Rev  addr:  0x3000000 

F2  ,NA 

F2  ,  NA 

NA 

NA 

11957 

:  65 

SCN  Port  Online 

F2  ,  P0 

F2  ,  PI 

21 

NA 

11957 

:  69 

*ELP  Send 

F2  ,  PI 

F2  ,  PI 

21 

0x277 

11957 

:  69 

SCN  Port  Online 

F2  ,  P0 

F2  ,  PI 

44 

NA 

11957 

:75 

*ELP  Send 

F2  ,  PI 

F2  ,  PI 

44 

0x279 

11957 

:  77 

ELP  Receive 

F2  ,  PI 

F2  ,  PI 

44 

0x277 

11957 

:78 

*ELP  Sending  ACC 

F2  ,  PI 

F2  ,  P2 

44 

0x277 

11957 

:  82 

ELP  Receive 

F2  ,  PI 

F2  ,  PI 

21 

0x279 

11957 

:  83 

*ELP  Sending  ACC 

F2  ,  PI 

F2  ,  P2 

21 

0x279 

11957 

:  87 

ELP  ACC  Receive 

F2  ,  P2 

F2  ,  P2 

21 

0x277 

switch : admin>  f abstateclear 

switch : admin>  fabstateshow 

Time 

Stamp 

Input  and  *Action 

S,  P 

Sn,  Pn 

Port 

Xid 

See  also 

f abStatsShow 
f abricLog 
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fabStateResize 


Changes  the  number  of  state  entries. 

Synopsis 

fabStateResize  num 

Operands 

This  command  has  the  following  operand: 

num  The  switch  DomainJD  and  embedded  port  D  ID 

Examples 

To  change  the  number  of  entries: 


switch : admin>  fabstateshow 

Time 
Xid 

Stamp 

Input  and  *Action 

S, 

P  Sn,Pn 

Port 

11955 

:655 

SCN  Switch  Online 

F2,NA 

F2 , NA  NA 

NA 

11955 

:657 

*Start  2  *  F_S_TOV  Timer 

F2  ,NA 

F2 , NA  NA 

NA 

11955 

:657 

*Start  60  *  F_S_T0V  Timer 

F2,NA 

F2 , NA  NA 

NA 

11955 

:669 

RSCN  Rev  addr:  0x3000000 

F2,NA 

F2 , NA  NA 

NA 

11957 

:65 

SCN  Port  Online 

F2  ,  P0 

F2,P1  21 

NA 

11957 
0x277 

:69 

*ELP  Send 

F2, 

PI  F2,P1 

21 

11957 

:69 

SCN  Port  Online 

F2  ,  P0 

F2,P1  44 

NA 

11957 
0x2  7  9 

:75 

*ELP  Send 

F2, 

PI  F2,P1 

44 

11957 
0x2  77 

:77 

ELP  Receive 

F2  , 

PI     F2 , PI 

44 

11957 
0x2  77 

:78 

*ELP  Sending  ACC 

F2  , 

PI  F2,P2 

44 

11957 
0x2  7  9 

:82 

ELP  Receive 

F2, 

PI  F2,P1 

21 

11957 
0x2  7  9 

:83 

*ELP  Sending  ACC 

F2  , 

PI  F2,P2 

21 

11957 
0x2  77 

:87 

ELP  ACC  Receive 

F2, 

P2  F2,P2 

21 

switch : admin>  f abstateresize  64 

Warning:  This  command  will  clear  the  logs. 

Are  your  sure  you  want  to  do  the  resize   [y/n] ? 

y 

switch : admin>  fabstateshow 

Time 
Xid 

Stamp 

Input  and  *Action 

s, 

P  Sn,Pn 

Port 
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See  also 

f abricLog 

f abStateClear 

f abStateShow 
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fabStateShow 


Displays  the  fabric  state  information. 


Synopsis 

f abstateshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  queue  of  fabric  state  information  logged  by  the  fabric. 


f2^f  NOTE:    This  command  is  obsoleted  by  f  abricLog  -s. 


Operands 


none 


Examples 


To  display  the  fabric  state  information: 
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switch : admin>  fabstateshow 


Time 

Stamp 

Input  and  *Action 

S, 

P 

Sn,  Pn 

Port 

Xid 

11955 

:  655 

SCN  Switch  Online 

F2 

NA 

F2 

NA 

NA 

NA 

11955 

:  657 

*Start  2  *  F_S_TOV  Timer 

F2 

NA 

F2 

NA 

NA 

NA 

11955 

:  657 

*Start  60  *  F_S_TOV  Timer 

F2 

NA 

F2 

NA 

NA 

NA 

11955 

:  669 

RSCN  Rev  addr:    0x3  0  00000 

F2 

NA 

F2 

NA 

NA 

NA 

11957 

:  65 

SCN  Port  Online 

F2 

P0 

F2 

PI 

21 

NA 

11957 

:  69 

*ELP  Send 

F2 

PI 

F2 

PI 

21 

0x277 

11957 

:  69 

SCN  Port  Online 

F2 

P0 

F2 

PI 

44 

NA 

11957 

:75 

*ELP  Send 

F2 

PI 

F2 

PI 

44 

0x2  7  9 

11957 

:  77 

ELP  Receive 

F2 

PI 

F2 

PI 

44 

0x2  7  7 

11957 

:78 

*ELP  Sending  ACC 

F2 

PI 

F2 

P2 

44 

0x277 

11957 

:  82 

ELP  Receive 

F2 

PI 

F2 

PI 

21 

0x2  7  9 

11957 

:  83 

*ELP  Sending  ACC 

F2 

PI 

F2 

P2 

21 

0x2  7  9 

11957 

:  87 

ELP  ACC  Receive 

F2 

P2 

F2 

P2 

21 

0x2  7  7 

11957 

:92 

ELP  ACC  Receive 

F2 

P2 

F2 

P2 

44 

0x2  7  9 

11957 

:94 

SCN  AC_PORT 

F2 

P2 

F2 

P3 

44 

NA 

11957 

:99 

SCN  AC_PORT 

F2 

P2 

F2 

P3 

21 

NA 

11957 

:  106 

SCN  AC_PORT 

F2 

P3 

F2 

P3 

21 

NA 

11957 

:  106 

SCN  AC_PORT 

F2 

P3 

F2 

P3 

44 

NA 

11957 

:364 

SCN  Port  Online 

F2 

P0 

F2 

PI 

31 

NA 

11957 

:366 

*ELP  Send 

F2 

PI 

F2 

PI 

31 

0x27b 

11957 

:382 

ELP  ACC  Receive 

F2 

PI 

F2 

P2 

31 

0x27b 

11957 

:  404 

SCN  AC_PORT 

F2 

P2 

F2 

P3 

31 

NA 

11957 

:  406 

*EFP  Send 

F2 

P3 

F2 

P3 

31 

0x27c 

11957 

:  434 

EFP  ACC  Receive 

F2 

P3 

F2 

P3 

31 

0x2  7  c 

11957 

:  514 

SCN  E_PORT 

F2 

P3 

F2 

P3 

31 

NA 

11957 

:987 

SCN  Domain  4  reachable 

F2 

NA 

F2 

NA 

NA 

NA 

11958 

:435 

ELP  Receive 

F2 

P0 

F2 

P0 

40 

Oxlbb 

11958 

:436 

*ELP  Sending  ACC 

F2 

P0 

F2 

P2 

40 

Oxlbb 

11958 

:  437 

SCN  Port  Online 

F2 

P0 

F2 

PI 

25 

NA 

11958 

:465 

SCN  AC_PORT 

F2 

P2 

F2 

P3 

40 

NA 

11958 

:  467 

*EFP  Send 

F2 

P3 

F2 

P3 

40 

0x294 

(output  truncated) 

See  also 

f abPortShow 
f abStateClear 
f abricLog 
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fabStatsShow 


Displays  the  fabric  statistics. 


Synopsis 


f abstatsshow 


Availability 

all  users 

Description 

Use  this  command  to  display  the  statistics  for  the  fabric.  The  information  appears  as  follows: 

•  Number  of  times  a  switch  domain  ID  has  been  forcibly  changed 

•  Number  of  E_Port  offline  transitions 

•  Number  of  fabric  reconfigurations 

•  Number  of  fabric  segmentations  due  to: 
Loopback 
Incompatibility 
Overlap 
Zoning 

EPort  segment 
Licensing 
Disabling  E  Port 
Platform  DB 

Security  incompatibility 
Security  violation 
ECP  error 
Duplicate  WWN 
E  Port  isolated 


Operands 


none 
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Examples 

To  display  the  fabric  statistics: 


switch : admin>  fabstatsshow 

Description 

Count 

Domain  ID  forcibly  changed: 

0 

E_Port  offline  transitions: 

0 

Reconfigurations : 

1 

Segmentations  due  to: 

Loopback : 

6  < 

Incompatibility : 

0 

Overlap : 

0 

Zoning : 

0 

E_Port  Segment : 

0 

Licensing : 

0 

Disabled  E_Port : 

0 

Platform  DB : 

0 

Sec  Incompatibility: 

0 

Sec  Violation: 

0 

ECP  Error: 

0 

Duplicate  WWN: 

0 

Eport  Isolated: 

0 

See  also 

f abRetryShow 
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fabSwitchShow 

Displays  the  fabric  switch  state  structure  information. 

Synopsis 

f abswitchshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  fabric  switch  state  structure  information. 


IMPORTANT:   This  command  is  provided  strictly  for  debugging  purposes;  it  is  not  intended  as  a  user 
z_l  command. 


Operands 

none 

Examples 

To  display  fabric  switch  state  structure: 


switch : admin>  f abswitchshow 

Fabric  Switch  State 

Structure  Information 

State: 

DO 

Stage : 

warm  done 

Rdi  Receive  Timer: 

0x10069400,    IDLE  STATE 

Unconfirmed  Sw  Timer 

:      0x10069508,    IDLE  STATE 

NTP  Timer: 

0xl00695b8,    IDLE  STATE 

ME  Timer : 

0x10069610,    IDLE  STATE 

Principal  Domain: 

2 

Upstream  Port: 

64 

Principal  Wwn: 

10:00:00:60:69:80:06:ce 

Principal  Priority: 

0x2 

Flags : 

0x40 

me  retry  count : 

0 

inq_sem  count : 

1 

dbg_sem  count: 

1 

ha  efp  count: 

0 

f ab_q  current  count : 

0 

f ab_q  high  water : 

8 

f ab_q  age : 

0  (sec) 

(continued  on  next  page) 
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TPTaTTVT     t"  "v™     m  q  c          ^  t"i      n  t*i  /-r 

n 
u 

h  o  n  )-     nVi  dr'V    t"\i~*  i  n  I-  • 
Lcb  U     OlitiCrv        U  J- 1 1  L  . 

TRUE 

fabric  EFP  version: 

7 

last  message: 

20:30:29.826  *Snd  inquiry  (4) 
NA 

DO , NA     DO , NA  NA 

NTP  ports  online: 

RSCN  domain  recovery 

list: 

no  domain  RSCN's  to  recover 

reachable  domains : 

13  4 

3  domains  reachable 

Ports  used  for  EFP/BF/DIA  flood: 

( output  truncated) 

See  also 

supportShow 
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fanDisable 

Disables  a  fan  unit. 

Synopsis 

fandisable  unit 

Availability 

admin 

Description 

Use  this  command  to  disable  a  nonfaulty  fan  unit  by  setting  the  RPM  speed  to  0. 

("2^f  NOTE:    This  command  is  not  available  on  nonbladed  systems  except  for  the  HP  StorageWorks  SAN 
Switch  4/32. 


Operands 

This  command  has  the  following  operand: 

unit  Specify  the  fan's  unit  number  to  disable.  View  the  fan  unit 

numbers  using  the  f  anShow  command.  This  operand  is 
required. 

Examples 

To  disable  a  fan  unit: 

switch : admin>  fandisable  1 

Fan  unit  1  has  been  disabled 

See  also 

f anEnable 
f anShow 
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fanEnable 

Enables  a  fan  unit. 

Synopsis 

fanenable  unit 

Availability 

admin 

Description 

Use  this  command  to  return  the  fan  unit  to  the  default  RPM  speed  (only  if  the  fan  unit  has  been  previously 
disabled  using  the  fanDisable  command). 

f-^f  NOTE:    This  command  is  not  available  on  nonbladed  systems  except  for  the  StorageWorks  SAN 
Switch  4/32. 


Operands 

This  command  has  the  following  operand: 

unit  Specify  the  fan's  unit  number  to  enable.  View  the  fan  unit 

numbers  using  the  f  anShow  command.  This  operand  is 
required. 

Examples 

To  enable  a  fan  unit: 

switch : admin>  fanenable  1 

Fan  unit  1  has  been  enabled 

See  also 

fanDisable 
f anShow 
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fanShow 


Displays  fan  status  and  speed. 


Synopsis 

f anshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  status  and  speed  of  each  fan  in  the  system. 
Fan  status  is  displayed  as: 


f2^>  NOTE:    The  output  from  this  command  varies  depending  on  switch  type  and  number  of  fans  present. 


OK 
absent 

below  minimum 
above  minimum 
unknown 
faulty 


Fan  is  functioning  correctly. 
Fan  is  not  present. 

Fan  is  present  but  rotating  too  slowly  or  stopped. 
Fan  is  rotating  too  quickly. 
Unknown  fan  unit  installed. 

Fan  has  exceeded  hardware  tolerance  and  has  stopped.  In  this 
case,  the  last  known  fan  speed  is  displayed. 


Operands 


none 


Examples 


To  display  information  on  the  fans  in  the  system: 


switch : admin>  f anshow 


Fan  #1  is  OK,    speed  is  2721  RPM 


Fan  #2  is  OK,    speed  is  2657  RPM 


Fan  #3  is  OK,    speed  is  2700  RPM 


See  also 


chassisShow 


f anDisable 


f anEnable 


psShow 
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fastBoot 

Reboots  the  control  processor  (CP),  bypassing  power-on  self-test  (POST). 

Synopsis 

f astboot 

Availability 

admin 

Description 

Use  this  command  to  reboot  the  CP.  The  reboot  takes  effect  immediately  as  the  CP  resets  and  executes 
normal  power-on  booting  sequence.  However,  POST  is  skipped,  reducing  boot  time  significantly. 

If  POST  has  been  disabled  using  the  diagDisablePost  command,  then  fastBoot  is  the  same  as 

reboot. 

Operands 

none 

Examples 

To  perform  a  reboot  without  executing  POST: 

switch :admin>  f astboot 

See  also 

diagDisablePost 

diagEnablePost 

reboot 
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faZoneAdd 

Adds  a  member  to  a  Fabric  Assist  zone. 

Synopsis 

fazoneadd  "  fazoneName",1' 'member;  member" 

Availability 

admin 

Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  Fabric  Assist  zone. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  agtCf  gShow 
command).  For  the  change  to  become  effective,  an  appropriate  Fabric  Assist  zone  configuration  must  be 
enabled  using  the  cfgEnable  command.  For  the  change  to  be  preserved  across  switch  reboots,  it  must 
be  saved  to  flash  memory  using  the  cfgSave  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  required  operands: 

fazoneName  Specify  the  name  of  the  Fabric  Assist  zone,  in  quotation  marks. 

member  Specify  a  list  of  Fabric  Assist  zone  members.  The  whole  list  must 

be  enclosed  in  quotation  marks  and  members  separated  by 
semicolons.  A  member  can  be  specified  by  one  or  more  of  the 
following  methods: 

Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"1,2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

*  WWNs  (for  example,  "10  :  49  :  00  :  00  :  00  : 20  :  3f  :  2e"). 
See  f  aZoneCreate  for  more  details  on  the  use  of  WWNs 
in  Fabric  Assist  zones. 

*  Fabric  Assist  zone  alias  names. 

*  Exactly  one  Fabric  Assist  host  member  (for  example, 

"H{1,2}"). 

Examples 

To  add  aliases  for  some  disk  arrays  to  "Blue_f  azone": 

switch : admin>  fazoneadd  "Blue_f azone" ,    "array3;   array4 ;   array5 " 

To  add  a  Fabric  Assist  host  member  to  "Blue_f  azone": 

switch : admin>  fazoneadd  "Blue_f azone" ,  "H{5,6}" 
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To  add  another  target  member  to  "Blue_f  azone": 

switch :admin>  fazoneadd  "Blue_fazone" ,    " 10 : 49 : 00 : 00 : 00 : 20 : 3 f : 2e " 

See  also 

f aZoneCreate 
f aZoneDelete 
faZoneRemove 
f aZoneShow 
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faZoneCreate 


Creates  a  Fabric  Assist  zone. 


Synopsis 


fazonecreate   fazoneName',  member;  member 


Availability 


admin 


Description 


Use  this  command  to  create  a  new  Fabric  Assist  zone.  You  must  specify  a  name  and  member  list.  The  FA 
zone  name  must  be  unique  among  all  Fabric  Assist  zone  objects.  The  member  list  must  be  enclosed  in 
quotation  marks  members  separated  by  a  semicolons. 

A  Fabric  Assist  zone  name  is  in  C  language  style.  It  must  begin  with  a  letter  and  be  followed  by  any 
number  of  letters,  digits,  and  underscore  characters.  Names  are  case  sensitive;  for  example,  "Zone_l" 
and  "f  azone_l"  are  different  Fabric  Assist  zones.  Spaces  are  ignored. 

The  Fabric  Assist  zone  member  list  must  have  at  least  one  FA  host  and  one  target  member.  Empty  lists  are 
not  allowed. 

When  a  Fabric  Assist  zone  member  is  specified  by  physical  fabric  port  number,  then  all  devices 
connected  to  that  port  are  in  the  Fabric  Assist  zone.  If  this  port  is  an  arbitrated  loop,  then  all  devices  on 
the  loop  are  in  the  Fabric  Assist  zone. 

WWNs  are  specified  as  eight  hex  numbers  separated  by  colons,  for  example, 
"10  :00:00:60:69:00:00:  8a".  Zoning  has  no  knowledge  of  the  fields  within  a  WWN;  the  eight 
bytes  are  simply  compared  with  the  node  and  port  names  presented  by  a  device  in  a  login  frame  (FLOGI 
or  PLOGI). 

When  a  Fabric  Assist  zone  member  is  specified  by  node  name,  then  all  ports  on  that  device  are  in  the 
Fabric  Assist  zone.  When  a  Fabric  Assist  zone  member  is  specified  by  port  name,  only  that  single  device 
port  is  in  the  Fabric  Assist  zone.  Zone  alias  names  have  the  same  format  as  Fabric  Assist  zone  names 
and  are  created  with  the  aliCreate  command.  The  alias  must  resolve  to  a  list  of  one  or  more  physical 
fabric  port  numbers,  WWNs,  or  a  Fabric  Assist  host. 

A  Fabric  Assist  host  member  is  defined  by  wrapping  the  physical  fabric  port  or  a  physical  device  (a 
WWN)  between  "h{"  and  "}".  For  example,  "h{5,  6}"  or  "h{10  :  00  :  00  :  60  :  69  :  00  :  00  :  8a}"  is  a 
Fabric  Assist  host.  The  type  of  Fabric  Assist  zone  members  used  to  define  a  Fabric  Assist  zone  might  be 
mixed  and  matched.  For  example,  a  Fabric  Assist  zone  defined  with  the  following  members  "2  , 12  ; 
2  , 14;  10:00:00:60:69:00:00:  8a"  would  contain  devices  connected  to  switch  2,  ports  1  2  and  14, 
and  the  device  with  a  WWN  of  "10  :00:00:60:69:00:00:  8a"  (either  node  name  or  port  name: 
whichever  port  in  the  fabric  it  is  connected  to.) 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cf  gShow 
command).  For  the  change  to  become  effective,  an  appropriate  Fabric  Assist  zone  configuration  must  be 
enabled  using  the  cfgEnable  command.  For  the  change  to  be  preserved  across  switch  reboots,  it  must 
be  saved  to  flash  memory  using  the  cfgSave  command. 


r2^f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 
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Operands 

The  following  operands  are  required: 

fazoneName  Specify  a  name  for  the  Fabric  Assist  zone.  The  name  must  be 

enclosed  in  quotation  marks. 

member  Specify  a  member  or  list  of  members  to  add  to  a  Fabric  Assist 

zone.  The  list  must  be  enclosed  in  quotation  marks,  members 
separated  by  semicolons.  A  member  can  be  specified  by  one  or 
more  of  the  following  methods: 

Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"l ,  2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

•  WWNs  (for  example,  "10  :  49  :  00  :  00  :  00  :  20  :  3  f  :  2e"). 
Fabric  Assist  zone  alias  names. 

•  Exactly  one  Fabric  Assist  host  member  (for  example, 

"H{1,  2}"). 

Examples 

To  create  three  Fabric  Assist  zones  using  a  mixture  of  port  numbers  and  Fabric  Assist  zone  aliases: 


switch; 

: admin> 

f azoneCreate 

"Red_fazone" , 

"H{1,0};  loopl" 

switch: 

: admin> 

f azoneCreate 

"Blue_f azone" , 

" H { 1 , 1 } ;   arrayl ;  1,2; 

array2 " 

switch: 

: admin> 

f azoneCreate 

" Green_f azone " 

,    "1,0;    loopl;  H{1,2}; 

array2 " 

See  also 

f aZoneAdd 
f aZoneDelete 
faZoneRemove 
f aZoneShow 
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faZoneDelete 


Deletes  a  Fabric  Assist  zone. 


Synopsis 


f azonedelete "fazonename 


Availability 


admin 


Description 


Use  this  command  to  delete  an  existing  Fabric  Assist  mode  zone  on  a  fabric. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cf  gShow 
command).  For  the  change  to  become  effective,  an  appropriate  Fabric  Assist  zone  configuration  must  be 
enabled  using  the  cfgEnable  command.  For  the  change  to  be  preserved  across  switch  reboots,  it  must 
be  saved  to  flash  memory  using  the  cfgSave  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


The  following  operand  is  required: 


fazonename 


Specify  the  name  of  the  zone  to  be  deleted,  in  quotation  marks. 


Examples 


To  delete  a  Fabric  Assist  zone: 


switch : admin>  f azonedelete  "Blue_fazone 


See  also 


f aZoneAdd 


f aZoneCreate 


f aZoneRemove 


f aZoneShow 
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faZoneRemove 

Removes  members  from  a  Fabric  Assist  zone. 

Synopsis 

f  azoneremove  "  fazoneName",  "member;  member  .  .  ." 

Availability 

admin 

Description 

Use  this  command  to  remove  one  or  more  members  from  an  existing  Fabric  Assist  zone. 

Each  deleted  member  must  be  found  by  an  exact  string  match.  Order  is  important  when  removing 
multiple  members  of  a  Fabric  Assist  zone.  For  example,  if  a  Fabric  Assist  zone  contains  "array2  ; 
array3  ;   array4",  removing  "array4;   array3"  fails  but  removing  "array3 ;   array4"  succeeds. 
If  issuing  this  command  results  in  all  members  being  removed,  the  Fabric  Assist  zone  is  deleted. 

This  command  does  not  change  the  defined  configuration  (which  you  can  view  using  the  cf  gShow 
command).  For  the  change  to  become  effective,  an  appropriate  Fabric  Assist  zone  configuration  must  be 
enabled  using  the  cfgEnable  command.  For  the  change  to  be  preserved  across  switch  reboots,  it  must 
be  saved  to  flash  memory  using  the  cfgSave  command. 


\^}f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

The  following  operands  are  required: 

fazoneName  Specify  a  name  for  the  Fabric  Assist  zone,  in  quotation  marks. 

member  Specify  a  member  or  list  of  members  to  remove  from  a  Fabric 

Assist  zone.  The  list  must  be  enclosed  in  quotation  marks, 
members  separated  by  semicolons.  A  member  can  be  specified 
by  one  or  more  of  the  following  methods: 

Enter  a  fabric  domain  and  area  number  pair  (for  example, 
"l ,  2").  View  the  area  numbers  for  ports  using  the 
switchShow  command. 

•  WWNs  (for  example,  "10  :  49  :  00  :  00  :  00  :  20  :  3  f  :  2e"). 
See  f  aZoneCreate  for  more  details  on  the  use  of  WWNs 
in  Fabric  Assist  zones. 

•  Fabric  Assist  zone  alias  names. 

•  Exactly  one  Fabric  Assist  host  member  (for  example, 

"H{1,  2}"). 

Examples 

To  remove  "array2"  from  "Blue_f  azone": 

switch : admin>  f azoneremove  "Blue_f azone" ,  "array2" 
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See  also 

f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZoneShow 
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faZoneShow 


Displays  Fabric  Assist  zone  information. 

Synopsis 

fazoneshow  ["pattern"  [ ,  trans flag] ] 

Availability 

all  users 

Description 

Use  this  command  to  display  Fabric  Assist  zone  information.  Specifying  this  command  with  no 
parameters  or  with  the  second  parameter  set  to  0  displays  all  Fabric  Assist  zone  configuration 
information  for  both  defined  and  effective  configurations.  Defined  configuration  information  is  shown 
from  the  transaction  buffer.  See  the  cf  gShow  command  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  Fabric  Assist  zone  names,  and  those  that 
match  in  the  defined  configuration  are  displayed. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  optional  operands: 

pattern  Specify  a  value  to  search  for  the  name  of  a  Fabric  Assist  zone. 

This  can  be  any  POSIX-style  expression.  Patterns  can  contain: 

•  Question  mark  (?),  which  matches  any  single  character 

•  Asterisk  (*),  which  matches  any  string  of  characters 

•  Ranges,  which  match  any  character  within  the  range: 
for  example,  [0-9]  or  [a-f] 

trans  flag  Specify  0  to  display  the  information  from  the  current  transaction, 

or  specify  1  to  display  information  from  the  original  buffer.  This 
operand  must  be  preceded  by  a  pattern.  If  this  operand  is 
omitted,  the  value  defaults  to  0. 

Examples 

To  display  all  Fabric  Assist  zones  beginning  with  the  letters  A  through  C: 

switch : admin>  fazoneshow  "[A-C]*" 
f azone :  Blue_fazone 

1,1;   arrayl ;   1,2;  array2 

See  also 

f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZoneRemove 
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fcPing 


Sends  a  Fibre  Channel  Extended  Link  Service  (ELS)  ECHO  request  to  a  pair  of  ports. 


Synopsis 

fcPing   [   -hbq  ]  [  -n  frames]  [  -1  length]  [  -i  wait]  [  -p  pattern]  source 
destination 

Availability 

all  users 

Description 

Use  this  command  to  perform  a  zoning  check  between  the  source  and  destination.  In  addition,  two 
Fibre  Channel  ELS  requests  are  generated.  The  first  ELS  request  is  from  the  domain  controller  to  the 
source  port  identifier.  The  second  ELS  request  is  from  the  domain  controller  to  the  destination  port 
identifiers.  The  ELS  ECHO  request  elicits  an  ELS  ECHO  response  from  a  port  identifier  in  the  fabric  and  is 
useful  for  validating  link  connectivity. 

The  source  and  destination  port  identifiers  can  be  specified  as  24-bit  Fibre  Channel  port  identifiers, 
port  world  wide  names,  or  node  world  wide  names.  The  two  port  identifiers  are  then  used  to  determine  if 
they  are  zoned  together. 

The  ELS  ECHO  requests  comprise  a  24-byte  Fibre  Channel  frame  header,  a  4-byte  ELS  request  header, 
an  8-byte  timestamp  from  gettimeof  day,  and  an  arbitrary  number  of  bytes  (as  specified  by  -1 
length)  to  fill  out  the  request  frame.  The  source  identifier  in  the  ELS  ECHO  request  is  the  domain 
controller  and  the  destination  identifier  is  either  source  or  destination. 

The  echo  ELS  might  not  be  supported  on  all  devices.  In  such  cases,  the  response  could  be  either  an  ELS 
reject  or  a  request  timeout. 

By  default,  fcPing  sends  five  ELS  ECHO  requests  to  each  port. 

("2^>  NOTE:   When  a  device  does  not  respond  to  the  ELS  request,  further  debugging  is  necessary  to 

understand  if  this  is  due  to  the  device  not  supporting  this  ELS  request.  The  user  should  not  assume  that  the 
device  is  not  FC-connected. 


Operands 

This  command  has  the  following  optional  operands: 

-n  frames  Specifies  the  number  of  ELS  ECHO  requests  to  send. 

-1  length  Specifies  requests  containing  length  bytes  of  data.  The  default  is 

0  bytes  of  data.  Without  data,  the  Fibre  Channel  ECHO  request 
frame  size  is  1  2  total  bytes.  This  is  a  combination  of  four  bytes 
from  the  ECHO  request  header  and  eight  bytes  from  the 
timestamp.  The  maximum  allowed  value  is  2,036  bytes.  The 
length  must  be  word  aligned. 

-h  Causes  the  program  to  display  the  proper  command  line  usage 

syntax  information  and  then  terminate. 

-i  wait  Specifies  the  interval,  in  seconds,  between  successive  ELS 

ECHO  requests.  The  default  is  0  seconds. 
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-p  pattern  Specifies  up  to  16  "pad"  bytes,  which  are  used  to  fill  out  the 

request  frame  payload  that  is  sent.  This  is  useful  for  diagnosing 
data-dependent  problems  in  the  fabric  link.  The  pattern  bytes 
are  specified  as  hexadecimal  characters.  For  example,  -p  ff 
causes  the  request  frame  to  be  filled  with  all  Is. 

-b  Specifies  to  bypass  the  zone  check  functionality. 

-q  Specifies  quiet  output.  Only  the  zoning  information  and  the 

summary  line  appear  upon  program  termination. 

source  Specifies  the  source  port  ID,  port  WWN,  or  node  WWN. 

destination  Specifies  the  destination  port  ID,  port  WWN,  or  node  WWN. 

Examples 

switch :admin>  fcPing  10 : 00 : 00 : 00 : c9 : 29 : Oe: c4  21 : 00 : 00 : 20 : 37 : 25 : ad: 05 

Source:  10 : 00 : 00 : 00 : c9 : 2 9 : Oe : c4 

Destination:  21:00:00:20:37:25: ad :05 

Zone  Check:  Not  Zoned 


Pinging  10 : 00 : 00 : 00 : c9 : 29 : Oe : c4  [0x20800]  with  12  bytes  of  data: 
received  reply  from  10 : 00 : 0 0 : 00 : c9 : 29 : Oe : c4 :  12  bytes  time:1162  usee 
received  reply  from  10 : 00 : 0 0 : 00 : c9 : 29 : Oe : c4 :  12  bytes  time:1013  usee 
received  reply  from  10 : 00 : 0 0 : 00 : c9 : 29 : Oe : c4 :  12  bytes  time:1442  usee 
received  reply  from  10 : 00 : 0 0 : 00 : c9 : 29 : Oe : c4 :  12  bytes  time:1052  usee 
received  reply  from  10 : 00 : 0 0 : 00 : c9 : 29 : Oe : c4 :  12  bytes  time:1012  usee 
5  frames  sent,  5  frames  received,  0  frames  rejected,  0  frames  timeout 
Round- trip  min/avg/max  =  1012/113  6/1442  usee 


Pinging  21 : 00 : 00 : 20 : 37 : 25 : ad: 05    [0x211e8]  with  12  bytes  of  data: 

Request  rejected 

Request  rejected 

Request  rejected 

Request  rejected 

Request  rejected 

5  frames  sent,  0  frames  received,  5  frames  rejected,  0  frames  timeout 
Round-trip  min/avg/max  =  0/0/0  usee 
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To  display  one  device  that  accepts  the  request  and  another  device  that  does  not  respond  to  the  request: 


switch: admin>  fcPing  0x020800  22 : 00 : 00 : 04 : cf : 75 : 63 : 85 

Source:  0x20800 

Destination:  22:00:00:04:cf:75:63:85 

Zone  Check:  Zoned 

Pinging  0x20800  with  12  bytes  of  data: 

received  reply  from  0x20800:   12  bytes  time: 1159  usee 

received  reply  from  0x20800:   12  bytes  time: 1006  usee 

received  reply  from  0x20800:   12  bytes  time: 1008  usee 

received  reply  from  0x20800:   12  bytes  time: 1038  usee 

received  reply  from  0x20800:   12  bytes  time: 1010  usee 

5  frames  sent,    5  frames  received,    0  frames  rejected,  0 

frames 

timeout 

Round-trip  min/avg/max  =  1006/1044/1159  usee 

Pinging  22  :  00 : 00 : 04 : cf : 75 : 63 : 85    [0x217d9]  with  12  bytes 

of  data: 

Request  timed  out 

Request  timed  out 

Request  timed  out 

Request  timed  out 

Request  timed  out 

5  frames  sent,   0  frames  received,   0  frames  rejected,  5 

frames 

timeout 

Round-trip  min/avg/max  =  0/0/0  usee 

See  also 

gettimeof day 
ping 
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fcpLogClear 

Clears  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

f cpLogClear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  debug  information  logged  by  FCPD. 

Operands 

none 

Examples 

To  clear  the  FCPD  debug  information  log: 

switch : admin>  fcplogclear 

See  also 

f cpLogDi sable 
f cpLogEnable 
f cpLogShow 
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fcpLogDisable 

Disables  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

fcpLogDisable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  debug  information  logged  by  FCPD. 

Operands 

none 

Examples 

To  disable  the  FCPD  debug  information  log: 

switch : admin>  fcpLogDisable 

See  also 

f cPing 

f cpLogEnable 
f cpLogShow 
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fcpLog  Enable 

Enables  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

f cpLogEnable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  debug  information  logged  for  FCPD.  Debug  information  logging  is 
enabled  by  default. 

Operands 

none 

Examples 

To  enable  the  FCPD  debug  information  log: 

switch : admin>  f cpLogEnable 

See  also 

f cPing 

f cpLogDi sable 
f cpLogShow 
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fcpLogShow 


Displays  the  FCPD  debug  information  log  (debug  command). 

Synopsis 

f cpLogShow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  debug  information  logged  at  various  stages  of  FCP  device  probing. 

Operands 

none 


Examples 

To  display  the  FCPD  debug  information  log: 


switch 

: admin> 

f cpLogShow 

Time  Stamp 

Event 

Port 

f ile&lineno 

argO 

argl 

arg2 

arg3 

arg4 

22 

34 

:10 

824 

FlshOrProbe 

26 

1 

459 

81 

0 

0 

:  0 

:  0 

22 

34 

:10 

824 

ProbeFlsh 

26 

1 

2755 

0 

0 

0 

:  0 

:  0 

22 

34 

:10 

825 

SCNRcvd 

26 

1 

3436 

2 

0 

0 

:  0 

:  0 

22 

34 

:14 

232 

FlshOrProbe 

26 

1 

459 

80 

0 

0 

:  0 

:  0 

22 

34 

:14 

232 

PrbMsg 

26 

1 

494 

0 

0 

0 

:  0 

:  0 

22 

34 

:14 

233 

StartProbe 

26 

1 

961 

1 

0 

0 

:  0 

:  0 

22 

34 

:14 

233 

StartProbe 

26 

1 

999 

0 

0 

0 

:  8000 

:  0 

22 

34 

:14 

233 

ProbeFlsh 

26 

1 

2755 

1 

0 

0 

:  0 

:  0 

22 

34 

:14 

234 

SndPLOGI 

26 

1 

1431 

1002a690 

llace 

1 

:  0 

:20526 

22 

34 

:14 

236 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:  1 

:10526 

22 

34 

:14 

236 

ElsRsp 

26 

1 

1606 

llace 

2000000 

20 

:  0 

:980000 

22 

34 

:14 

238 

SndPRLI 

26 

1 

2026 

1002a690 

llace 

2 

:  527 

:  0 

22 

34 

:14 

239 

AsyResp 

26 

1 

1540 

1002a690 

1002a8e8 

80 

:2 

:10527 

22 

34 

:14 

239 

ElsRsp 

26 

1 

1606 

llace 

2100014 

0 

:21 

:980000 

22 

34 

:14 

240 

SndINQ 

26 

1 

2504 

1002a690 

2 

528 

:  0 

:  0 

22 

34 

:14 

244 

AsyResp 

26 

1 

1540 

1002a690 

1002a5f 0 

80 

:  5 

:10528 

22 

34 

:14 

244 

INQRsp 

26 

1 

1852 

1 

llace 

880008 

: llace 

:  0 

22 

34 

:14 

244 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:  5 

:10528 

22 

34 

:14 

244 

INQRsp 

26 

1 

1852 

7 

llace 

980000 

: llace 

:  0 

22 

34 

:14 

245 

SndLOGO 

26 

1 

1939 

llace 

1002a690 

0 

:  0 

:20529 

22 

34 

:14 

245 

SndLOGO 

26 

1 

1946 

74f 

0 

0 

:  0 

:  0 

22 

34 

:14 

247 

AsyResp 

26 

1 

1540 

1002a690 

1002a768 

80 

:4 

:10529 

22 

34 

:14 

247 

ElsRsp 

26 

1 

1606 

llace 

2000000 

0 

:  0 

:980000 

22 

34 

:14 

247 

IUDel 

26 

1 

1731 

1002a690 

1002a690 

0 

:  0 

:  1 
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See  also 

f cPing 

f cpLogDi sable 
f cpLogEnable 
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fcpProbeShow 

Displays  the  Fibre  Channel  Protocol  (FCP)  probe  information. 

Synopsis 

f cpprobeshow  [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  FCP  probing  information  for  the  devices  attached  to  the  specified  F  Port 
or  FLPort.  This  information  includes  the  number  of  successful  logins  and  SCSI  INQUIRY  commands  sent 
over  this  port  and  a  list  of  the  attached  devices. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  list  valid  ports.  This  operand  is 
required. 

Examples 

To  display  the  FCP  probe  information: 


switch : admin>  f cpprobeshow  4/4 

port  52  is  L-Port  and 

it  is  online. 

nodes  probed: 

2 

successful  PLOGIs: 

2 

successful  PRLls: 

2 

successful  INQUIRies: 

2 

successful  LOGOS: 

2 

outstanding  IUs : 

0 

probing  state: 

3 

probing  TOV: 

0 

probing  count: 

0 

probing  next : 

0 

pmap : 

0x00000000,  0x00000000, 

0x00000000, 

0x00000010 

update  map : 

0x00000000,  0x00000000, 

0x00000000, 

0x00000010 

list  of  devices (may  include  old  devices  on  the 

loop) : 

0x2b4e2 :    IBM  DDYF- 

T09170R  F60N 

0x2b4e4 :   IBM  DDYF- 

T09170R  F60N 
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See  also 

portLoginShow 
portLogShow 
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fcpRlsShow 

Display  the  Fibre  Channel  Protocol  (FCP)  Read  Link  Status  (RLS)  information. 

Synopsis 

f  cprlsshow  [slotnumber /]portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  FCP  RLS  information  for  a  particular  device,  which  should  be  either  an 
F  Port  or  FLPort.  This  information  describes  the  number  of  loss-of-signal,  loss-of-sync,  CRC-error,  and 
other  failure  events  that  have  been  detected  on  this  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  list  valid  ports.  This  operand  is 
required. 

Examples 

To  display  the  FCP  RLS  information: 


switch 

admin>  f cprlsshow  2/5 

link  fail       loss  sync 

loss  sig 

prtc  err 

bad  word 

crc  err 

Oxda 

0  5 

0 

0 

525 

0 

Oxdc 

0  3 

0 

0 

330 

0 

See  also 

portLoginShow 
portLogShow 
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fdmiCacheShow 

Displays  abbreviated  remote  FDMI  device  information,  according  to  remote  domain  ID. 

Synopsis 

f dmicacheshow 

Availability 

all  users 

Description 

Use  this  command  to  display  FDMI  cache  information  for  remote  domains  only. 

The  state  of  each  remote  domain,  identified  by  its  domain  ID,  is  shown  to  be  unknown,  known, 
unsupported,  or  error. 

The  revision  of  the  switch  also  displays,  followed  by  the  world  wide  name  of  the  switch. 

For  HBAs,  only  the  HBA  identifiers  and  registered  port  lists  are  displayed.  No  detailed  HBA  attributes  are 
displayed.  For  registered  ports,  only  port  identifier  and  corresponding  HBA  are  shown;  no  detailed  port 
attributes  are  displayed. 

Operands 

none 

Examples 

To  display  the  FDMI  cache: 


switch : admin>  f dmicacheshow 

Switch  entry  for  domain  3 

state:  known 

version:  v310 

wwn:  10:00:00:60:69:90:03 

c7 

HBAS  : 

10:00:00:00:c9:25:9b:96 

Ports :  1 

10:00:00:00:c9:25:9b:96 

Total  count  of  devices  on  the 

switch  is  1 

f dmiShow 
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fdmiShow 

Displays  detailed  FDMI  device  information. 

Synopsis 

f dmishow 

Availability 

all  users 

Description 

Use  this  command  to  display  FDMI  information  for  all  HBAs  and  ports. 

Detailed  FDMI  information  is  displayed  for  local  HBAs  and  ports.  This  information  includes  the  HBA  with 
its  corresponding  ports,  along  with  their  respective  attributes. 

Only  abbreviated  FDMI  information  is  shown  for  HBA  and  ports  on  remote  switches. 

Operands 

none 

Examples 

To  display  FDMI  information  on  a  local  switch: 

switch : admin>  f dmishow 
Local  HBA  database  contains: 
10:00:00:00:c9:25:9b:96 
Ports:  1 

10:00:00:00:c9:25:9b:96 
Port  attributes: 

FC4  Types:  0x0001000001000000000000000000000000000000000000000000000000000000 

Supported  Speed:  0x00000001 

Port  Speed:  0x00000001 

Frame  Size:  0x00000800 
HBA  attributes: 

Node  Name:   20 : 00 : 00 : 00 : c9 : 25 : 9b: 96 
Manufacturer:   Emulex  Network  Systems 
Serial  Number:  0000c9259b96 
Model:  LP9000 

Model  Description:   Emulex  LightPulse  LP9000  1  Gigabit  PCI  Fibre 
Hardware  Version:  00000001 

Driver  Version:   SLI-2  SW_DATE : May     3  2002,   v5-2.11a2  **CT_TEST  1** 

Firmware  Version:  03814101 

OS  Name  and  Version:  Window  2  000 

Max  CT  Payload  Length:  0x00061300 

(continued  on  next  page) 
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Local  Port  database  contains : 
10:00:00:00:c9:25:9b:96 

Remote  HBA  database  contains  no  entry. 

Remote  Port  database  contains  no  entry. 

See  also 

f dmiCacheShow 


ficonClear 

Clears  the  records  from  the  specified  FICON  database. 

Synopsis 

f iconclear [database] 

Availability 

all  users 

Description 

Use  this  command  to  remove  records  from  the  local  FICON  database.  The  command  effect  depends  on 
the  specified  database. 

Operands 

The  operand  is  as  follows: 

database  Specifies  the  name  of  the  FICON  database.  The  databases  are: 

RLIR  Removes  all  entries  from  the  link  incidents  database. 

RNID  Removes  all  the  not  current  entries  from  the  device 

node  identification  database.  There  are  four  devices 
that  are  not  removed  from  the  RNID  database. 

Examples 

To  clear  the  RLIR  database: 

switch :user>  f iconclear  RLIR 
successfully  clear  local  RLIR  Database. 

To  clear  RNID  database: 

switch:user>  ficonclear  RNID 
successfully  clear  not  current 
entries  from  local  RNID  Database. 

See  Also 

f iconHelp 
f iconShow 
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ficoncupset 

Sets  FICON-CUP  parameters  for  a  switch. 

Synopsis 

ficoncupset  fmsmode  enable   |  disable 
ficoncupset  modereg  bitname  0    |  1 

Availability 

admin 

Description 

Use  this  command  to  set  FICON-CUP  (Control  Unit  Port)  parameters  for  a  switch.  All  the  parameters 
described  below  can  be  set  while  the  switch  is  online.  Changes  to  parameters  are  effective  immediately.  A 
reboot  is  not  required  for  the  changes  to  take  effect. 

Operands 

The  following  operands  are  supported: 

fmsmode  Enable  or  disable  the  FICON  Management  Server  (FMS)  mode  for  the 

switch.  When  parameter  is  fmsmode,  argument  is  either  enable  or 
disable. 

modereg  Set  a  bit  in  the  FICON-CUP  mode  register.  When  parameter  is  modereg, 

one  of  the  following  bitname  operands  should  be  specified,  followed  by  0 


or  1: 

POSC 

Programmed  offline  state  control 

UAM 

User  alert  mode 

ASM 

Active=saved  mode 

DCAM 

Director  clock  alert  mode 

ACP 

Alternate  control  prohibited 

HCP 

Host  control  prohibited 

Examples 

To  enable  FMS  mode  for  the  switch: 

switch : admin>  ficoncupset  fmsmode  enable 
fmsmode  for  the  switch  is  now  Enabled 

To  set  ASM  bit  in  the  mode  register  for  the  switch: 

switch : admin>  ficoncupset  modereg  ASM  1 
Active=Saved  Mode  bit  is  set  to  1 

See  Also 

f iconcupshow 
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ficoncupshow 

Displays  FICON-CUP  parameters  for  a  switch. 

Synopsis 

ficoncupshow  fmsmode 
ficoncupshow  modereg  [bitname] 

Availability 

all  users 

Description 

Use  this  command  to  display  FICON-CUP  (Control  Unit  Port)  parameters  for  a  switch. 

Operands 

The  following  operands  are  supported: 

fmsmode  Display  the  FICON  Management  Server  (FMS)  mode  for  the  switch. 

modereg  Display  the  FICON-CUP  mode  register.  When  parameter  is  modereg, 

one  of  the  following  arguments  can  be  specified  as  bitname: 


POSC  Programmed  offline  state  control 

UAM  User  alert  mode 

ASM  Active=saved  mode 

dcam  Director  clock  alert  mode 

acp  Alternate  control  prohibited 

hcp  Host  control  prohibited 


If  no  argument  is  specified,  all  the  mode  register  bits  are  displayed.  If  a 
mode  register  bit  is  specified,  then  only  the  value  of  that  bit  is  displayed. 
A  value  of  1  indicates  that  a  given  mode  register  bit  is  set,  and  0 
indicates  that  it  is  not  set. 

Examples 

To  display  FMS  mode  for  the  switch: 

switch :user>  ficoncupshow  fmsmode 
fmsmode  for  the  switch:  Enabled 

To  display  mode  register  for  the  switch: 

switch :user>  ficoncupshow  modereg 
POSC     UAM     ASM     DCAM     ACP  HCP 


10         1  110 
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To  display  ASM  bit  in  the  mode  register  for  the  switch 

switch :user>  ficoncupshow  modereg  ASM 
ASM 

1 

See  Also 

f iconcupset 


ficonHelp 

Displays  a  list  of  FICON  support  commands. 

Synopsis 

f iconhelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  FICON  support  commands,  with  descriptions. 

Operands 

none 

Examples 

To  display  a  list  of  FICON  commands: 


switch : admin>  f iconhelp 

f iconshow 

RNID 

Displays  all  RNID  (Registered  Node  Identification 
Data)   for  FICON  devices  connected  to  the  local  switch. 

f iconshow 

RNID  fabric 

Displays  all  RNID  entries  within  the  fabric. 

f iconshow 

LIRR 

Displays  all  LIRR  (Link  Incident  Record  Registration) 
entries  for  FICON  hosts  that  registered  with  the 
local  switch. 

f iconshow 

LIRR  fabric 

Displays  all  LIRR  entries  within  the  fabric. 

f iconshow 

SwitchRNID 

Displays  switch  node  identification  data  of  the  local 
switch. 

f iconshow 

SwitchRNlD  fabric          Displays  switch  node  identification  data  of 

each  switch  in  the  fabric . 

f iconshow 

RLIR 

Displays  all  RLIR  (Registered  Link  Incident  Record) 
entries  within  the  local  switch. 

f iconshow 

RLIR  fabric 

Displays  all  RLIR  entries  within  the  fabric. 

(continued  on  next  page) 
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ficonshow  ILIR 

Displays  all  ILIR   (Implicit  Link 

Incident  Record) 

entries  within  the  local  switch. 

ficonshow  ILIR  fabric 

Displays  all  ILIR  entries  within 

the  fabric . 

ficonclear  RLIR 

Clears  the  RLIR  entries  from  the 

local  RLIR  database 

ficonclear  RNID 

Clears  the   'not  current'  entries 

from  the  local 

RNID  database. 
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ficonShow 


Synopsis 


Displays  the  contents  of  the  specified  FICON  database. 

ficonshow  RNID  [fabric] 
ficonshow  LIRR  [fabric] 
ficonshow  SwitchRNID  [fabric] 
ficonshow  RLIR  [fabric] 
ficonshow  ILIR  [fabric] 


Availability 

all  users 

Description 

Use  this  command  to  display  the  contents  of  a  FICON  database.  The  ficonshow  database  operand  is 
the  name  of  the  database  to  display.  If  the  fabric  operand  is  absent,  the  command  displays  the 
members  of  the  named  database  that  are  local  to  the  switch  on  which  the  command  was  issued.  If  the 
fabric  operand  is  present,  it  must  be  entered  exactly  as  shown,  and  this  specifies  that  all  members  are 
displayed,  both  local  and  remote. 

The  following  information  might  be  displayed,  depending  on  which  database  you  enter  and  which 
operands  you  use  with  the  command: 


Domain 
Fabric  WWN 
Flag 


Displays  the  domain  ID. 
Displays  the  fabric  WWN. 

Indicates  if  the  node  is  valid,  not  valid,  or  not  current.  Flag  values  are 
as  follows: 

0x00 


0x10 
0x20 

0x30 

0x40 

0x50 


Indicates  node  ID  of  the  storage  port  for  RNID 
switch  for  SwitchRNID  is  valid. 

Indicates  node  ID  of  the  channel  port  is  valid. 

Indicates  the  node  ID  of  the  storage  port  is  not 
current. 

Indicates  the  node  ID  of  the  channel  port  is  not 
current. 

Indicates  the  node  ID  of  the  storage  port  for 
RNID  switch  for  RLIR  is  not  valid. 

Indicates  the  node  ID  of  the  channel  port  is  not 
valid. 


Fmt 

FRU  Failure  Description 


FRU  Part  Number 


Displays  the  record-registration  format. 

Indicates  the  FRU  failure  type  as  one  of  the  following: 

•  WWN  card  [unit  number] 

•  Power  Supply  [unit  number] 

•  Hardware  Slot  [unit  number] 

•  Blower  [unit  number] 
Displays  the  FRU  part  number. 
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FRU  Serial  Number 
Incident  Count 

Link  Incident  Description 
Link  Incident  Type 


Listener  PID 
Listener  Port  Type 
Listener  Port  WWN 
Listener  Type 
I 


Manufacturer 
Model  Number 
Node  Parameters 
Parameters 


Parm 


Displays  the  FRU  serial  number. 

Displays  the  incident  count.  This  number  increases  by  1  for  each 
incident  within  the  individual  switch. 

Same  as  Link  Incident  Type. 

Indicates  the  link  incident  type  as  one  of  the  following: 

Bit-error-rate  threshold  exceeded 

Loss  of  signal  or  synchronization 

NOS  recognized 

Primitive  sequence  timeout 

Invalid  primitive  sequence  for  port  state 
Same  as  PID. 
Same  as  Port  Type. 

Displays  the  channel  HBA  port  world  wide  name. 
Indicates  the  listener  type  as  follows: 

Conditiona  This  port  receives  a  link  incident  record  if  no 

other  recipients  from  the  established 
registration  list  have  been  chosen. 

Unconditional  This  port  is  always  chosen  as  a  recipient  of  a 

link  incident  record. 

Displays  the  manufacturer  name  or  code. 

Displays  the  model  number. 

Same  as  Parameters. 

Displays  the  node  type  for  the  switch  in  three  bytes,  OxAABBCC: 
Byte  AA      0x20        FC-SB-2  and  updates. 
Byte  BB       0x0a  Switch. 

Byte  CC      0x00        Port  number.  It  is  dynamically  assigned 
whenever  a  link  incident  occurs. 

Displays  the  incident  node  parameters  type  in  three  bytes, 
OxAABBCC: 

Byte  AA 


Byte  BB 


0x00 

Reserved. 

0x20 

FC-SB-2  and  updates. 

0x40 

Other  FC-4s  including  FCP  and  updates. 

0x60 

FC-SB-2  and  updates  and  other  FC-4s 
including  FCP  and  updates. 

0x80 

FC-4  support  not  specified. 

OxaO 

Reserved. 

OxcO 

Reserved. 

OxeO 

Vendor  specific. 

0x00 

Unspecified  class. 

0x01 

Direct  access  storage  device,  if  it  is  an  storage 
port;  otherwise,  not  channel-to-channel 
capable. 

0x02 

Magnetic  tape,  if  it  is  an  storage  port; 
otherwise,  a  reserved  field  for  a  channel  port. 
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Part  Number 
PID 

Plant  of  Manufacture 
Port 

Port  Status 


Port  Type 


Protocol 

Registered  Node  WWN 

Registered  Port  WWN 

Sequence  Number 
Serial  Number 
Switch  node  WWN 
Switch  Port  WWN 
Switch  WWN 
Tag 

TS  Format 
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0x03        Input  unit  record,  if  it  is  an  storage  port; 

otherwise,  a  reserved  field  for  a  channel  port. 

0x04        Output  unit,  if  it  is  an  storage  port;  otherwise, 
a  reserved  field  for  a  channel  port 

0x05        Reserved  field  for  a  channel  port. 

0x06        Controller,  if  it  is  an  storage  port;  otherwise,  a 
reserved  field  for  a  channel  port. 

0x07        Terminal  ■  Full  screen  if  it  is  an  storage  port; 

otherwise,  a  reserved  field  for  a  channel  port. 

0x08        Terminal  ■  Line  mode  if  it  is  an  storage  port; 

otherwise,  an  emulated  control  unit  support 
only. 

0x09  Reserved. 

0x1 0        Switch,  if  it  is  a  switch  device;  otherwise, 
reserved. 

OxOb-Oxff  Reserved. 

Byte  CC      0x00        If  storage  CU  port  has  registered  with  the 
switch. 

OxID  CHIPID  if  channel  port  has  registered  with  the 

switch. 

OxPN  If  switch  has  registered  with  the  channel,  PN 

represents  the  FL  port  number. 

Displays  the  switch  chassis  part  number. 

Displays  the  24-bit  Fibre  Channel  port  address  in  OxDDAAPP  format. 
DD  is  Domain  ID.  AA  is  Area  ID.  PP  is  AL_PA  ID. 

Displays  the  manufacturer  plant  name  or  code. 

Physical  port  number 

Displays  the  status  of  the  port: 

Link  degraded  but  operational 

•  Link  not  operational 
Displays  the  port  type: 

•  U  is  unknown. 

•  N  is  N_Port. 

•  NL  is  NL_Port. 

Displays  whether  the  traffic  is  using  FICON  or  FCP. 

Displays  the  device's  node  world  wide  name  associated  with  the 
device  HBA. 

Displays  the  device's  channel  or  storage  CU  port  world  wide  name 
associated  with   the  device  HBA. 

Displays  the  sequence  number  of  the  self  describing  node. 
Displays  the  switch  serial  number. 
Displays  the  switch  node  world  wide  name. 
Displays  the  switch  port  world  wide  name. 
Displays  the  switch  WWN. 

Displays  the  physical  identifier  for  the  self-describing  node  interface. 
Displays  the  Time  Server  format. 


Time  Stamp 
Type 

Type  Number 


Displays  the  timestamp,  expressed  in  date  format. 
Same  as  Port  Type. 

Displays  the  type  number  of  the  self  describing  node.  It  also  describes 
the  machine  type. 


Operands 


This  command  has  the  following  operands: 
database  Specify  the  database  to  display.  Valid  values  are: 

•  RNID 

•  LIRR 

•  Switch  RNID 

•  RUR 

•  ILIR 


fabri c 


This  operand  is  required. 

Specify  fabric  to  display  both  local  and  remote  information;  if 
omitted,  only  members  of  the  named  database  that  are  local  to 
the  switch  on  which  the  command  is  issued  displays. 


Examples 


To  display  the  local  RNID  database: 


switch : admin>  ficonshow  RNID 
{ 

{Fmt    Type  PID  Registered  Port  WWN  Registered    Node  WWN        flag  Parm 

0x18  N         502b00  50 : 05 : 07 : 64 : 01 : 00 : 15 : 8d  50 : 05 : 07 : 64 : 00 : cl : 69 : ca  0x10  0x200110 
Type  number:  002064 
Model  number:  101 
Manufacturer:  IBM 
Plant  of  Manufacture:  02 
Sequence  Number:  0000000169CA 
tag:  102b 

} 

{Fmt    Type  PID  Registered  Port  WWN  Registered    Node  WWN        flag  Parm 

0x18  N         502e00  50 : 05 : 07 : 64 : 01 : 40 : Of : ca  50 : 05 : 07 : 64 : 00 : cl : 69 : ca  0x10  0x200105 
Type  number:  002064 
Model  number:  101 
Manufacturer:  IBM 
Plant  of  Manufacture:  02 
Sequence  Number:  0000000169CA 
tag:  052e 

} 

} 
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To  display  the  local  and  remote  LIRR  database: 


switch : admin>  ficonshow  LIRR  fabric 
{Fmt     Type  PID        Listener  Port  WWN 
0x18  N  502b00  50:05:07:64:01:00: 

0x18  N  502e00  50:05:07:64:01:40: 
0x18  N  511b00  50:05:07:64:01:00: 
0x18  N  511C00  50:05:07:64:01:40: 

0x18  N  531800  50:05:07:64:01:40: 

} 

The  LIRR  database  has  5  entries . 


Switch  Port  WWN  Listener  Type 

15:8d  20:2b:00:60:69:80:le:4e  Conditional 

0f:ca  20 : 2e : 00 : 60 : 69 : 80 : le : 4e  Conditional 

0f:ca  20:lb:00:60:69:80:le:4f  Conditional 

0d:d0  20:lc:00:60:69:80:le:4f  Conditional 

13:70  20:18:00:60:69:33:33:33  Conditional 


To  display  the  local  SwitchRNID  database: 

switch : admin>  ficonshow  SwitchRNID 
{ 

{Switch  WWN  flag  Farm 

10:00:00:60:69:80:le:4e  00  200a00 

Type  number:  002109 
Model  number:  Ml  2 

Manufacturer:  BRD 
Plant  of  Manufacture:  CA 
Sequence  Number:  OFT02X801E4E 
tag:  OOff 

} 

} 

The  Local  switch  RNID  database  has  1  entries. 
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To  display  the  local  RLIR  database: 


switch :user>  ficonshow  RLIR 


{Fmt     Type  PID        Port  Incident  Count  TS  Format       Time  Stamp 
0x18  N        502e00       46  1  Time  server  Mon  Jan  13  04:29:33  2003 

Port  Status :  Link  not  operational 

Link  Failure  Type:         Loss  of  signal  or  synchronization 


Registered  Port  WWN  Registered  Node  WWN  Flag    Node  Parameters 

50:05:07:64:01:40:0f :ca  50 : 05 : 07 : 64 : 00 : cl : 69 : ca     0x50  0x200105 

Type  Number:  002064 

Model  Number:  101 

Manufacturer:  IBM 

Plant  of  Manufacture:  02 

Sequence  Number:  0000000169CA 

tag:  2e00 


Switch  Port  WWN  Switch  Node  WWN  Flag    Node  Parameters 

20:2e:00:60:69:80:le:4e  10 : 00 : 00 : 60 : 69 : 80 : le : 4e     0x00  0x200a2e 
Switch  Part  Number:  060-0001501-05 
Switch  Serial  Number:  0FT02X801E4E 
Domain:  20480 

} 

} 

The  local  RLIR  database  has  1  entry. 
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To  display  the  local  I  LI  R  database: 

switch :user>  ficonshow  ILIR 
{ 

{FRU  Failure   [2]:   Power  Supply[2]    failure  occurred  on  Mon  Jan  13  12:11:38  2003 

Fmt       Protocol  Domain  Fabric  WWN  Switch  WWN 

0x18     FICON         80  10:00:00:60:69:33:33:33   10 : 00 : 00 : 60 : 69 : 80 : le : 4e 

FRU  part  number:  23000000602 
FRU  serial  number:  FL2L0001071 

{Listener  Port  Type  Listener  PID  Listener  Port  WWN 
N  0x502b00  50:05:07:64:01:00:15:8d 

} 

} 

{FRU  Failure   [3]:   Power  Supply[4]    failure  occurred  on  Mon  Jan  13  12:11:38  2003 

Fmt       Protocol  Domain  Fabric  WWN  Switch  WWN 

0x18     FICON         80  10:00:00:60:69:33:33:33   10 : 00 : 00 : 60 : 69 : 80 : le : 4e 

FRU  part  number:  23000000602 
FRU  serial  number:  FL2L0001060 

{Listener  Port  Type  Listener  PID  Listener  Port  WWN 
N  0x502b00  50:05:07:64:01:00:15:8d 

} 

} 

} 

The  Local  ILIR  database  has  2  entries . 

See  Also 

f iconClear 
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filterTest 

Tests  frame  filters. 

Synopsis 

filtertest   [--slot  slotnumber]  [-passcnt  passcnt]  [-txports 
itemlist]  [-scamoff  offset]  [-dcamoff  offset]  [-fdefoff  offset] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  ASIC  frame-level  filtering  logic  including  every  type  of  filter  actions: 

FLTACT_LIST_A  Action  to  handle  the  subgroup  A-based  filtering. 

FLTACT  LIST  B  Action  to  handle  the  subgroup  B-based  filtering. 

FLTACTFROZEN  Action  to  handle  the  frame  frozen  process. 

FLTACTDISCARD  Action  to  discard  frame. 

FLTACT_FORWARD  Action  to  forward  frame. 

This  command  can  be  run  on  every  port  and  send  the  frame  in  internal  loopback  mode.  The  filter  test 
requires  two  different  ports  in  the  same  quadrant  because  the  filter  logic  in  the  transmitter  port  cannot 
work  if  the  frame  is  sent  directory  from  the  embedded  port. 

In  this  test,  the  filter  definition  covers  the  different  filtering  conditions,  shown  in  Table  1 1 . 
Table  1 1    List  of  filter  test  numbers,  definitions,  and  action  types 


Number 

Filter  definition 

Action  type 

0 

unconditional  match 

Forward 

1 

unconditional  match 

List  A 

2 

unconditional  match 

List  B 

3 

unconditional  match 

Frozen 

4 

unconditional  match 

Discard 

5 

SCAM  no  match  and  AL_PA  match 

List  A 

6 

SCAM&DCAM  match  and  AL_PA  match 

List  A 

7 

Zone  A  match  and  AL_PA  match 

List  A 

8 

Zone  B  match  and  AL_PA  match 

List  B 

9 

Zone  A&B  match  and  AL_PA  match 

List  B 

10 

Zone  A|  B  match  and  AL_PA  match 

Frozen 

11 

Zone  A|  B  match  and  AL_PA  match 

Discard 
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["2^>  NOTE:   This  command  is  not  supported  on  the  HP  StorageWorks  4/8  or  4/1 6  SAN  switch,  the  HP 
\=fi    StorageWorks  SAN  Switch  4/32,  or  the  HP  StorageWorks  4/256  SAN  Director,  which  use  the  Condor 
ASIC. 


Operands 


This  command  has  the  following  operands: 


--slot  slotnumber 

-passcnt  passcnt 
-txports  itemlist 
-scamoff  offset 

-dcamoff  offset 

-fdefoff  offset 


Specify  the  slot  number  on  which  the  diagnostic  operates.  The 
port  specified  are  relative  to  this  slot  number.  The  default  is  0 
and  designed  to  operate  on  fixed-port-count  products. 

Specify  the  number  of  times  to  perform  this  test.  The  default  value 
is  1. 

Specify  the  user  port  numbers  to  perform  this  test.  All  user  ports 
are  set  by  default. 

Specify  the  program  location  to  write  SCAM  test  data  in  SCAM 
memory.  The  default  value  is  0.  The  maximum  offset  number  is 
set  if  the  specified  number  is  larger  than  the  limit. 

Specify  the  program  location  to  write  DCAM  test  data  in  DCAM 
memory.  The  default  value  is  0.  The  maximum  offset  number  is 
set  if  the  specified  number  is  larger  than  the  limit. 

Specify  the  program  location  to  write  filter  test  definition  data  in 
filter  definition  memory.  The  default  value  is  0.  The  maximum 
offset  number  is  set  if  the  specified  number  is  larger  than  the 
limit. 


Examples 


To  run  a  frame  filter  test: 

switch: admin>  filtertest  -txports  3/1-3/3 

Running  filtertest   

Test  Complete:   filtertest  Pass  1  of  1 
Duration  0  hr,    0  min  &  2  sec  (0:0:2:679). 
passed. 

Diagnostics 

When  it  detects  failures,  the  subtest  might  report  one  or  more  of  the  following  error  messages: 

DIAG-ACTTEST 

DIAG-FLTINIT 

DIAG-FLTRCV 

DIAG-FLTXMIT 

DIAG-NUMTEST 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 


itemList 
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firmwareCommit 


Commits  switch  firmware. 

Synopsis 

f irmwarecommit 

Availability 

admin 

Description 

Use  this  command  to  commit  a  firmware  download  to  a  CP.  This  command  copies  an  updated  firmware 
image  to  the  secondary  partition  and  commits  both  partitions  of  the  CP  to  an  updated  version  of  the 
firmware.  This  must  be  done  after  each  firmware  download  and  after  the  switch  has  been  rebooted  and  a 
sanity  check  is  performed  to  make  sure  the  new  image  is  fine. 

For  switches  that  have  flash  memory  set  into  two  equal  partitions,  the  primary  partition  is  the  where  the 
system  boots  from;  the  secondary  partition  is  where  a  copy  of  the  firmware  is  stored,  in  case  the  primary 
partition  is  damaged. 

To  maintain  the  integrity  of  the  firmware  image  in  the  flash  memory,  the  f  irmwareDownload  command 
updates  the  secondary  partition  only.  When  f  irmwareDownload  completes  successfully  and  the  CP  is 
rebooted,  the  system  switches  the  primary  partition  (with  the  old  firmware)  to  the  secondary,  and  the 
secondary  partition  (with  the  new  firmware)  to  the  primary. 

The  default  behavior  of  the  f  irmwareDownload  command  is  to  automatically  run  the 
firmwareCommit  command  after  the  reboot.  If  you  decide  to  disable  the  autocommit  option  when 
running  f  irmwareDownload,  after  the  CP  is  rebooted,  you  must  execute  one  of  two  commands: 

•  firmwareCommit  copies  the  primary  partition  (with  new  firmware)  to  the  secondary  and  commits  the 
new  firmware  to  both  partitions  of  the  CP. 

•  f  irmwareRestore  copies  the  secondary  partition  (with  the  old  firmware)  to  the  primary  and  backs 
out  of  the  new  firmware  download.  The  f  irmwareRestore  command  can  be  run  only  if  autocommit 
was  disabled  during  the  firmware  download.  Autocommit  can  be  disabled  only  when  you  run 

f  irmwareDownload  in  single  mode. 

Operands 

none 

Examples 

To  commit  a  new  version  of  the  firmware: 

switch : admin>  f irmwarecommit 
Validating  primary  partition. . . 
Doing 

firmwarecommit  now. 
Please  wait  . . . 
Replicating  kernel  image 


FirmwareCommit  completes  successfully. 
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See  also 

f irmwareDownload 
f irmwareRestore 
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firmwareDownload 


Downloads  switch  firmware  from  a  remote  host  or  local  directory. 

Synopsis 

f irmwaredownload   [ [   -s    [   -b  -n  -i  ]    ]   host , user , pfile , passwd 

Availability 

admin 

Description 

Use  this  command  to  download  switch  firmware  from  an  FTP  server  or  from  a  local  NFS  directory  to  the 
switch's  nonvolatile  storage  area. 

The  new  firmware  is  in  the  form  of  RPM  packages  with  names  defined  in  pfile,  a  binary  file  that  contains 
specific  firmware  information  (time  stamp,  platform  code,  version,  and  so  forth)  and  the  names  of 
packages  of  the  firmware  to  be  downloaded.  These  packages  are  made  available  periodically  to  add 
features  or  to  remedy  defects.  Contact  customer  support  to  obtain  information  about  available  firmware 
versions. 

In  dual-domain  systems,  this  command  by  default  downloads  the  firmware  image  to  both  CPs  in  rollover 
mode,  to  prevent  disruption  to  application  services.  This  operation  depends  on  HA  support.  If  HA  is  not 
available,  a  user  can  still  upgrade  the  CPs  one  at  a  time,  using  the  -s  option. 

All  systems  supported  by  this  firmware  have  two  partitions  of  nonvolatile  storage  areas,  a  primary  and  a 
secondary,  to  store  two  firmware  images.  firmwareDownload  always  loads  the  new  image  into  the 
secondary  partition  and  swaps  the  secondary  partition  to  be  the  primary.  It  then  reboots  the  CP  and 
activates  the  new  image.  Finally,  it  performs  the  f  irmwareCommit  procedure  automatically,  to  copy  the 
new  image  to  the  other  partition,  unless  -n  is  used. 

The  command  supports  both  non interactive  and  interactive  modes.  If  it  is  invoked  without  any  command 
line  parameters,  or  if  there  is  any  syntax  error  in  the  parameters,  the  command  goes  into  interactive  mode, 
in  which  you  are  prompted  for  input. 


A 


CAUTION:    For  each  non-director-class  switch  in  your  fabric,  complete  all  firmware  download  changes 
before  issuing  the  firmwareDownload  command  on  the  next  switch  to  ensure  a  nondisruptive 
download. 


"22^>  NOTE:  See  the  HP  StorageWorks  Fabric  OS  5.x  procedures  user  guide  for  information  about  limitations 
when  changing  Fabric  OS  versions.  When  installing  Fabric  OS,  the  procedure  might  vary,  depending  on 
which  version  of  the  Fabric  OS  you  are  migrating  from. 


Operands 

By  default,  firmwareDownload  performs  a  full  installation,  autoreboot,  and  autocommit.  These  modes 
are  selectable  only  in  single-CP  (-s)  mode,  in  which  case,  autoreboot  is  off  by  default.  A  user  can 
change  these  settings  interactively  or  by  using  the  following  options: 

-s  Specify  this  operand  to  enable  single-CP  mode.  In  dual-CP  systems,  this 

mode  enables  a  user  to  upgrade  a  single  CP  and  to  select  full  install, 
autoreboot,  and  autocommit. 
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-b  Specify  this  operand  to  activate  autoreboot  mode.  After  downloading 

firmware,  the  system  must  be  rebooted.  If  single-CP  mode  is  enabled  and 
this  operand  is  not  specified,  the  user  must  issue  the  reboot  command 
manually  to  activate  the  downloaded  image.  If  autoreboot  mode  is 
enabled,  the  switch  reboots  automatically  after  the  f  irmwareDownload 
command  has  been  run. 

-n  Specify  this  operand  to  deactivate  autocommit  mode.  By  default,  after 

running  this  command  and  after  the  reboot,  the  switch  performs  a 
f  irmwareCommit  command  automatically.  When  this  mode  is  disabled, 
the  user  needs  to  issue  the  f  irmwareCommit  command  manually  to 
replicate  the  downloaded  image  to  both  partitions  of  a  CP. 

-i  Specify  to  activate  incremental  upgrade  mode.  By  default,  this  command 

installs  all  the  packages  in  the  pf/7e.  When  this  mode  is  enabled,  the  names 
of  the  packages  in  pfile  are  compared  to  those  installed  on  the  switch, 
and  only  the  packages  whose  names  are  different  are  installed. 

host  Specify  a  host  server  name  or  IP  address:  for  example,  citadel  or 

"192.168.166.30".  The  pfile  is  downloaded  from  this  host.  If  this 
operand  is  not  used,  the  pfile  is  considered  to  be  accessible  through  a 
local  directory. 

user  Specify  a  user  name  for  FTP  server  access:  for  example,  "jdoe".  This  user 

name  is  used  to  gain  access  to  the  host.  This  operand  can  be  omitted  if 
pfile  is  accessible  through  a  local  directory  or  if  the  FTP  user  ID  is 
anonymous. 

pfile  Specify  a  fully  qualified  path  and  file  name:  for  example, 

/v5  .  0  . 1 /release. plist.  Absolute  path  names  might  be  specified 
using  forward  slash  (/). 

passwd  Specify  a  password.  This  operand  can  be  omitted  if  pfile  is  accessible 

through  a  local  directory  or  if  no  password  is  required  by  the  FTP  server. 

If  no  operand  is  specified,  the  operation  becomes  interactive  and  you  are  prompted  for  input. 

Examples 

To  download  the  firmware  to  an  HA  switch: 
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switch : admin>  f irmwareDownload 

192. 168. 166 . 3  0, johndoe, /pub/dist /release .plist , 12  345 


This  command  will  upgrade  both  CPs  in  the  switch.   If  you 
want  to  upgrade  a  single  CP  only,  please  use  -s  option. 

You  can  run  f irmwareDownloadStatus  to  get  the  status  of 
this  command. 

This  command  will  cause  the  active  CP  to  reset  and  will 
require  that  existing  telnet,    secure  telnet  or  SSH  sessions 
be  restarted. 

Do  you  want  to  continue   [Y] : 


FirmwareDownload  has  started  in  Standby  CP.  It  may  take  up  to  10 
minutes . 


And  you  will  the  following  on  Standby  CP: 
Start  to  install  packages  

dir  ################################################ 
terminfo  ################################################ 
termcap  ################################################ 
glibc  ################################################ 


sin  ################################################ 
Write  kernel  image  into  flash. 


Verification  SUCCEEDED 

Firmwaredownload  completes  successfully. 


Diagnostics 

The  following  can  cause  the  download  to  fail: 

•  Host  is  not  known  to  the  switch 

Host  cannot  be  reached  by  the  switch 

•  User  does  not  have  permission  on  host 
The  pfile  does  not  exist  on  host 

•  The  pfile  is  not  in  the  right  format 

•  Package  specified  in  the  pfile  does  not  exist 
9  The  FTP  server  is  not  running  on  host 

•  Running  f  irmwareDownload  during  POST 

•  A  loss  of  power  to  the  switch 
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See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

f irmwareCommit 

f irmwareDownloadStatus 

f irmwareRestore 

f irmwareShow 

reboot 

version 
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f  irmwa  reDown  loadStatus 


Displays  the  status  of  a  firmware  download. 

Synopsis 

f irmwaredownloadstatus 

Availability 

admin 

Description 

Use  this  command  to  display  an  event  log  that  records  the  progress  and  status  of  the  current 

f  irmwareDownload  command.  The  event  log  is  created  by  the  current  f  irmwareDownload  command 
and  is  kept  until  another  f  irmwareDownload  command  is  issued.  There  is  a  timestamp  associated  with 
each  event. 

In  systems  with  two  control  processor  (CP)  cards,  when  f  irmwareDownloadStatus  is  run,  the  event 
logs  whether  the  two  CPs  are  synchronized.  The  command  can  be  run  from  either  CP. 

Operands 

none 

Examples 

To  display  the  status  of  a  firmware  download: 

switch : admin>  f irmwaredownloadstatus 
[1]:   Tue  Jan  18  13:21:25  2004 

cpl :  Firmwaredownload  has  started  on  Standby  CP.  This  step  will  take 
up  to  3  0  minutes. 

[1]:   Tue  Jan  18  13:21:35  2004 

cpl:  Firmwaredownload  has  completed  successfully  on  Standby  CP. 

[2]:   Tue  Jan  18  13:21:37  2004 
cpl :   Standby  CP  reboots . 

[3]:   Tue  Jan  18  13:24:44  2004 
cpl:   Standby  CP  boots  up. 

[4]:   Tue  Jan  18  13:24:45  2004 

cpl:   Standby  CP  booted  up  with  new  firmware. 

[5]:   Tue  Jan  18  13:24:51  2004 

cpO :  Active  CP  forced  failover  succeeded.  Now  this  CP  is  becoming 
Active . 

(coninued  on  next  page) 
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[6]:   Tue  Jan  18  13:27:07  2004 

cpO :  Firmwaredownload  has  started  on  Standby  CP.  This  step  will  take 
up  to  3  0  minutes. 

[7]:  Tue  Jan  18  13:31:20  2004 

cpO :   Firmwaredownload  has  completed  successfully  on  Standby  CP. 

[8]:   Tue  Jan  18  13:31:23  2004 
cpO :   Standby  CP  starts  reboot. 

[9]:   Tue  Jan  18  13:33:54  2004 

cpO :   Standby  CP  booted  up  with  new  firmware. 

[10]:   Tue  Jan  18  13:33:56  2004 

cpO :   Firmwarecommit  has  started  on  both  Activs  and.  Standby  CPs . 
[11]:   Tue  Jan  18  13:38:29  2004 

cpO :   Firmwarecommit  has  completed  successfully  on  Active  CP. 
[12]:   Tue  Jan  18  13:38:30  2004 

cpO :   Firmwaredownload  has  completed  successfully. 

See  also 

firmwarecommit 
f irmwareDownload 
f irrawareRestore 
f irmwareShow 
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firmwareRestore 

Restores  the  former  active  firmware  image. 

Synopsis 

f irmwarerestore 

Availability 

admin 

Description 

Use  this  command  to  restore  the  former  active  firmware  image.  This  command  can  only  be  run  if 
autocommit  was  disabled  during  the  f  irmwareDownload. 

After  a  f  irmwareDownload  and  a  reboot  (with  autocommit  disabled),  the  downloaded  firmware 
becomes  active.  If  you  then  do  not  want  to  commit  the  firmware  and  want  to  restore  the  former  firmware, 

run  firmwareRestore.  After  running  firmwareRestore,  you  can  run  f  irmwareDownload  again. 

This  command  reboots  the  system  and  makes  the  former  firmware  active.  After  reboot,  both  primary  and 
secondary  partitions  restore  to  the  former  firmware. 

This  command  only  takes  action  if  the  system  is  booted  after  a  f  irmwareDownload;  otherwise,  it  returns 
with  an  error  code. 

Operands 

none 

Examples 

To  restore  the  former  active  firmware  image: 


switch : admin>  f irmwarerestore 

Restore  old  image  to  be  active  . . . 

Restore  both  primary  and  secondary  image  after 

reboot . 

The  system  is  going  down  for  reboot  NOW  !  ! 

Broadcast  message  from  root   (ttySO)   Fri  Oct  2  6 

23  :48 : 54  2001 .  .  . 

Doing  f irmwarecommit  now. 

Please  wait  . . . 

See  also 

f irmwareCommit 
f irmwareDownload 
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firmwareShow 

Displays  the  Fabric  OS  versions  on  both  partitions  of  the  local  and  remote  CPs. 

Synopsis 

f irmwareshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  Fabric  OS  versions  on  primary  and  secondary  partitions.  For  systems 
with  multiple  control  processor  (CP)  cards,  this  command  displays  this  information  for  both  local  and 
remote  CPs. 

Operands 

none 

Examples 

To  display  the  firmware  version  of  a  singleOP  system: 

switch : admin>  f irmwareshow 
Primary  partition:  v5 . 0 . 1 
Secondary  Partition:  v5 . 0 . 1 


To  display  the  firmware  version  of  a  dualOP  system: 


switch : admin>  f irmwareshow 

Local  CP   (Slot  5,   CP  1) : 

Active 

Primary  partition: 

v5  .  0  . 1 

Secondary  Partition: 

v5  .  0  . 1 

Remote  CP   (Slot  6,   CP  0): 

Standby 

Primary  partition: 

v5  .  0  . 1 

Secondary  Partition: 

v5  .  0  . 1 

Note:   If  Local  CP  and  Remote  CP  have  different  versions 

of  firmware,   please  retry 

f irmwaredownload  command. 

See  also 

f irmwareDownload 

f irmwareDownloadStatus 
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fportTest 


Functional  test  of  F->N,  N->F  point-to-point  path. 

Synopsis 

fporttest   [-nframes  count] [-ports  itemlist]  [-seed  payload_j?attern] [-width 
pa ttern_ width]  [-size  pattern_size] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  functional  operation  of  the  switch  by  sending  ELS  ECHO  frames  from  the 
switch  FPort  transmitter  and  receiving  ELS  ECHO  ACC  from  the  N_Port  device  into  the  F_Port  receiver. 
This  exercises  all  the  switch  components,  from  the  main  board,  to  the  SFP,  to  the  fiber  cable,  to  the  SFPs  (of 
the  N_Port  devices  and  the  switch  F_Port),  and  back  to  the  main  board. 

The  cables  and  SFPs  connected  should  be  of  the  same  technology;  that  is,  a  short  wavelength  SFP  (switch) 
port  is  connected  to  another  short  wavelength  SFP  (device)  port  using  a  short  wavelength  cable,  a  long 
wavelength  port  is  connected  to  a  long  wavelength  port;  and  a  copper  port  is  connected  to  a  copper 
port. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  rapidly  flicker  green  while  the 
test  is  running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  F  Ports. 

2.  Create  an  ELS_ECHO  frame  with  payload  size,  data  pattern  build  in  or  payload  size,  data  pattern. 

3.  Transmit  frame  F  through  the  F  Port,  with  D  ID,  to  the  N  Port  device. 

4.  Wait  for  the  N_Port  device  to  respond  ECHO  ACC. 

5.  Compare  ECHO  data  transmitted  to  ECHO  data  received. 

6.  Repeat  steps  3  through  5  for  all  ports  present  until  either  the  number  of  frames  requested  is  reached,  or 
all  ports  are  marked  bad. 

You  can  specify  a  payload  pattern  to  be  used  when  executing  this  test.  If  the  pattern  is  not  user  specified, 
then  at  every  30  pass,  a  different  data  type  from  a  palette  of  seven  is  used  to  generate  a  different  data 
pattern  to  create  the  frame.  The  data  pattern  is  generated  based  on  data  type.  Some  data  types  might 
generate  a  different  data  pattern  on  every  pass;  other  data  types  might  not  change  the  data  pattern  in 
every  pass.  These  seven  data  types  are  repeated  every  210  pass.  The  data  palette  is  as  follows: 


CSPAT (0) : 

0x7e, 

0x7e, 

0x7e, 

0x7e,  . 

BYTE_LFSR ( 1 ) : 

0x69, 

0x01, 

0x02  , 

0x05,  . 

CHALF_SQ(2) : 

0x4a, 

0x4a, 

0x4a, 

0x4a,  . 

QUAD_N0T(3) : 

0x00, 

Oxff , 

0x00, 

Oxff,  . 

CQTR_SQ ( 4 ) : 

0x78, 

0x78, 

0x7  8, 

0x78,  . 

CRPAT ( 5 ) : 

Oxbc, 

Oxbc, 

0x2  3, 

0x47,  . 

RANDOM (6) : 

0x2  5, 

0x7f , 

0x6e, 

0x9a,  . 
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Operands 

This  command  has  the  following  optional  operands: 

■nframes  count  Specify  the  number  of  times  (or  number  of  frames  per  port)  to  execute 

this  test.  If  count  is  omitted,  the  default  of  10  is  used. 

-ports  i  temlist  Specify  the  ports  to  test.  If  i  temlist  is  omitted,  the  test  is  executed  on 

all  online  F_Ports  in  the  specified  slot. 

-seed  payload_pattern  Specify  the  pattern  of  the  test  packets  payload.  Valid  values  are: 

0  CSPAT  (default) 

1  BYTELFST 

2  CHALF_SQ 

3  QUADNOT 

4  CQRT_SQ 

5  CRPAT 

6  RANDOM 

-width  pattern_width  Specify  the  width  of  the  pattern.  Valid  values  are: 

1  byte 

2  word 
4  quad 

-size  pattern_size  Specify  the  number  of  words  in  the  test  packet  payload.  If 

pattern_size  is  omitted,  the  default  value  is  51  2. 

Examples 

To  run  fportTest  on  a  switch: 

switch: admin>  fporttest  -ports  1/0-1/15 

Running  fPortTest   

Test  Complete:    "fporttest"  Pass  10  of  10 
Duration  0  hr,    0  min  &  1  sec  (0:0:0:127). 
passed. 


Diagnostics 

The  following  are  possible  error  messages  if  failures  are  detected: 

DATA 
INIT 

PORT_DIED 

E  P 1 1_S  TATUS_ERR 

ERR_STAT 

ERR_STATS 

ERR_STATS_2 LONG 

ERR_STATS_BADEOF 

ERR_STATS_BADOS 

ERR_STATS_C3DISC 

ERR_STATS_CRC 

ERR_STATS_ENCIN 

ERR_STATS_ENCOUT 

ERR_STATS_TRUNC 

ERR_STAT_2 LONG 

ERR_STAT_BADEOF 
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ERR_STAT_BADOS 

ERR_STAT_C3DISC 

ERR_STAT_CRC 

ERR_STAT_ENCIN 

ERR_STAT_ENCOUT 

ERR_STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_S  EGMENT 

PORT_ABSENT 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for  more 
information. 

See  also 

cross PortTest 

itemList 

loopPortTest 

portTest 

spinFab 
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fru  Replace 

Interactive  interface  to  replace  a  field  replaceable  unit  (FRU). 

Synopsis 

frureplace  FRU 

Availability 

admin 

Description 

Use  this  command  to  guide  the  user  in  replacing  an  FRU.  The  command  automatically  performs  the 
necessary  backup  and  restore  (steps  to  accommodate  the  replacement). 

Operands 

This  the  following  operand  is  required: 

fru  Specify  the  type  of  hardware  component  being  replaced.  WWN  is 

the  only  supported  value;  it  specifies  the  replacement  of  the 
WWN  card. 


Examples 

To  replace  the  world  wide  name  card: 

switch : admin>  frureplace  wwn 

This  is  the  WWN  card  hot  swap  interface. 

Continuing  from  this  point  will  require 

the  whole  process  to  be  completed. 

If  this  process  is  not  complete  due  to  a 

power  cycle,   or  CP  failover,   please  follow 

the  recovery  procedure  in 

Core  Switch    WWN  Card  Removal  and 

Replacement  document. 

Do  you  wish  to  continue   [y/n] ?  y 

Backing  up  WWN  card  data,  please 
wait  about  25  seconds  for  further 
instruction . 

Please  install  the  new  FRU  now. 
(continued  on  next  page) 
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If  this  session  lost  for  any  reason, 
please  re-enter  the  frureplace  command  and 
follow  the  instructions  to  complete  the 
operation . 

Please  enter  the  word  " continue'  after  the 

new  WWN  card  has  been  installed:  continue 

Restoring  the  information  to  the 

replacement  FRU  now,  please  wait  about 

20  seconds  to  complete 

Verifying  the  replacement  FRU  now. . . 

WWN  card  hot  swap  is  now  complete. 

FRU  replacement  completed  successfully! 

See  also 

none 
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fspfShow 

Displays  Fabric  Shortest  Path  First  (FSPF)  protocol  information. 

Synopsis 

f spf show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  FSPF  protocol  information  and  internal  data  structures  to  the  FSPF 
module. 

Table  1  2  describes  the  information  that  this  command  displays. 
Table  12    f  spf  show  display  fields 


Field 

Description 

version 

Version  of  FSPF  protocol. 

domainID 

Domain  number  of  local  switch. 

switchOnline 

State  of  the  local  switch. 

domainValid 

TRUE  if  the  domain  of  the  local  switch  is  currently  confirmed. 

isl_ports 

Bit  map  of  all  the  ISL  ports.  Bit  positions  correspond  to  the  default 
areas  of  the  ports.  Bit  0  refers  to  default  area  of  the  switch,  bit  1 

r             i   r     i             i          i        r  i 

refers  to  detault  area  1 ,  and  so  torth. 

trunk_ports 

Pi  "                            fill  II 

Bit  map  ot  all  the  trunk  slave  ports. 

t_ports 

n  ■!                £     1 1  il       r~      n  i 

Bit  map  ot  all  the  rx_rorts. 

seg_ports 

Bit  map  of  all  the  segmented  ports. 

active_ports 

Bit  map  of  all  the  ONLINE  ports. 

minLS  Arrival 

FSPF  constant. 

minLSInterval 

FSPF  constant. 

LSoriginCount 

Internal  variable. 

startTime 

Start  time  of  the  FSPF  task  from  boot  time,  in  milliseconds. 

fspfQ 

FSPF  input  message  queue. 

fabP 

Pointer  to  fabric  data  structure. 

agingTID 

Aging  timer  ID. 

agingTo 

Aging  time  out  value,  in  milliseconds. 

IsrDlyTID 

Link  State  Record  delay  timer  ID. 
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Table  12    f  spf  show  display  fields 


Field 

Description 

IsrDelayTo 

Link  State  Record  delay  time  out  value,  in  milliseconds. 

IsrDelayCount 

Counter  of  delayed  Link  State  Records. 

ddb_sem 

FSPF  semaphore  ID. 

event_sch 

FSPF  scheduled  events  bit  map. 

Operands 

none 

Examples 

To  display  FSPF  protocol  information: 


switch : admin>  f spf show 

version 

= 

2 

domainID 

= 

131 

switchOnline 

= 

TRUE 

doma invalid 

— 

TRUE 

isl_ports [0] 

= 

0x00000000 

isl_ports [1] 

= 

0x74000000 

trunk__ports  [  0  ] 

= 

0x00000000 

trunk__ports  [  1  ] 

0x02000000 

f_ports [ 0 ] 

0x00400000 

f_ports [1] 

= 

0x00000000 

seg_ports  [  0 ] 

0x00000000 

seg_ports [1] 

0x00000000 

active_ports [ 0 ] 

0x00400000 

active_ports [1] 

0x76000000 

minLSAr rival 

3 

minLS Interval 

5 

LSoriginCount 

3 

startTime 

50222 

fspfQ 

0xl003e640 

fabP 

0xl003e630 

agingTID 

0xl004ca28 

agingTo 

10000 

lsrDlyTID 

0xl00507a8 

IsrDelayTo 

5000 

IsrDelayCount 

1 

ddb_sem 

0xl003e6e8 

fabP: 

event_sch 

0x0 
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See  also 

bcastShow 

topologyShow 

uRouteShow 
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fwAla  rms  Fi  IterSet 


Enables  or  disables  alarms  for  Fabric  Watch. 


Synopsis 

fwalarmsf ilterset  [mode] 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  configure  alarm  filtering  for  Fabric  Watch.  By  turning  off  the  alarms,  all 
non-environment  class  alarms  are  suppressed.  By  turning  on  the  alarms,  all  class  alarms  are  generated. 

Operands 

This  command  has  the  following  operand: 


switch : admin>  fwalarmsf ilterset 
Committing  configuration ...  done . 
FW:  Alarms  are  disabled 

switch : admin>  fwalarmsf ilterset  1 
Committing  configuration ...  done . 
FW:  Alarms  are  enabled 


mode 


Specify  1  to  enable  the  alarms,  0  to  disable  the  alarms.  If  no 
operand  is  specified,  the  default  value  is  0  (alarms  deactivated).  This 
operand  is  optional. 


Examples 


To  enable  alarms  in  Fabric  Watch: 


See  also 


fwAlarmsFi Iter Show 
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fwAlarmsFilterShow 


Displays  alarm  filtering  for  Fabric  Watch. 


Synopsis 


fwalarmsf i Iter show 


Availability 


all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Use  this  command  to  display  whether  alarm  filtering  is  enabled  or  disabled. 


To  display  the  status  of  alarm  filtering  in  Fabric  Watch: 

switch :user>  fwalarmsf iltershow 
FW:  Alarms  are  enabled 

switch :user>  fwalarmsf iltershow 
FW:  Alarms  are  disabled 


Description 


Operands 


none 


Examples 


See  also 


fwAlarmsFi Iter Set 
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fwClasslnit 


Initializes  all  classes  under  Fabric  Watch. 


Synopsis 

fwclassinit 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  initialize  all  classes  under  Fabric  Watch.  The  command  should  be  used  only  after 
installing  a  Fabric  Watch  license  to  start  licensed  Fabric  Watch  classes.  See  fwConf  igure  for  a  list  of 


classes. 


Operands 


none 


Examples 


To  initialize  all  classes  under  Fabric  Watch: 


switch : admin>  fwclassinit 


fwClasslnit:   Fabric  Watch  is  updating... 


fwClasslnit:  Fabric  Watch  has  been  updated. 


See  also 


fwConf igReload 


fwConf igure 


fwShow 
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fwConfig  Reload 

Reloads  the  Fabric  Watch  configuration. 

Synopsis 

fwconf igreload 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  reload  the  Fabric  Watch  configuration.  This  command  should  be  used  only  after 
downloading  a  new  Fabric  Watch  configuration  file  from  a  host. 

Operands 

none 

Examples 

To  reload  the  saved  Fabric  Watch  configuration: 

switch : admin>  fwconf igreload 

fwConf igReload :   Fabric  Watch  configuration  reloaded 

See  also 

conf igDownload 
conf igUpload 
fwClassInit 
fwConf igure 
fwShow 
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fwConfigure 

Displays  and  modifies  the  Fabric  Watch  configuration. 

Synopsis 

fwconfigure    [--enable  --port  portNumber]    |    [--disable  --port  portNumber] 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  and  modify  threshold  information  for  the  Fabric  Watch  configuration.  Switch 
elements  monitored  by  Fabric  Watch  are  divided  into  classes,  which  are  further  divided  into  areas.  Each 
area  can  include  multiple  thresholds.  In  addition,  the  command  can  be  used  to  disable  or  enable  all 
thresholds  associated  with  a  given  port. 

The  Fabric  Watch  classes  and  areas  are  provided  in  Table  1  3. 


'23}f  NOTE:  Not  all  platforms  support  fans  or  power  supplies.  If  you  attempt  to  configure  values  for  these 
U    items,  an  ERROR:  No  threshold  available  error  message  is  displayed. 


Table  13     fwConfigure  fabric  watch  classes  and  areas 


Class 

Area 

Environmental 

Temperature 

Fan 

Power  Supply 

SFP 

Temperature 

RXP 

TXP 

Current 

Voltage 
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Table  13     fwConfigure  fabric  watch  classes  and  areas  (continued) 


Class 

Area 

Port 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPerformance 

Stntp  (  nnnnpi 

Fabric 

E_Port  downs 

Fabric  reconfigure 

Domain  ID  changes 

Segmentation  changes 

Zone  changes 

Fabric<->QL 

1  UUr  It-  I'-'tJ  1 1  lb 

SFP  state  changes 

E_Port 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPerformance 

State  Changes 
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Table  13     fwConf  igure  fabric  watch  classes  and  areas  (continued) 


Class 

Ar@Q 

F/FL_Port  (Optical) 

Link  loss 

Sync  loss 

Signal  loss 

Protocol  error 

Invalid  words 

Invalid  CRCS 

RXPerformance 

TXPerformance 

State  Changes 

AL  PA  Performance  Monitor 

invana  v_i\v^o 

EE  Performance  Monitor 

Invalid  CRCS 

RXPerformance 

TXPerformance 

Filter  Performance  Monitor 

Customer  Define 
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Table  13     fwConfigure  fabric  watch  classes  and  areas  (continued) 


Ar©o 

Security 

Telnet  Violations 

HTTP  Violations 

API  Violations 

RSNMP  Violations 

WSNMP  Violations 

SES  Violations 

MS  Violations 

Serial  Violations 

Front  Panel  Violations 

SCC  Violations 

DCC  Violations 

Login  Violations 

Invalid  Timestamps 

Invalid  Signatures 

Invalid  Certificates 

SLAP  Failures 

SLAP  Bad  Packets 

TS  Out  of  Sync 

No-FCS 

Incompatible  Security  DB 

Illegal  Command 

Resource 

Flash 

Operands 

This  command  has  the  following  optional  operands: 

--enable  --port  portNumber  Enables  all  thresholds  associated  with  a  certain  port, 

--disable  --port  portNumber       Disables  all  thresholds  associated  with  a  certain  port. 
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Examples 

To  configure  thresholds: 


switch : admin>  fwconfigure 

1   :   Environment  class 

2    :   SFP  class 

3    :   Port  class 

4   :   Fabric  class 

5   :  E-Port  class 

6   :   F/FL  Port   (Optical)  class 

7   :  Alpa  performance  Monitor  class 

8   :  EE  performance  Monitor  class 

Q      ■          ~i  "1  I-  o  v    ■fiQV'fi"!  T"m  Z3  n     o    TvT  i~\ti  i  ^~  r-i  t"     o  ~]  ;a  o  o 
^3      .      JT  _L  J_  L  fc;  -L     ^Jfc:i.J_U-L  lllcLIl^  t:    I'lUIll  UUI  Lluob 

10   :   Security  class 

11   :  Resource  class 

12    :  Quit 

Select  a  class  =>  :    (1..12)    [1]  1 

1   :  Temperature 

2    :  Fan 

3    :   Power  Supply 

4   :   return  to  previous  page 

Select  an  area  =>   :    (1..4)    [4]  1 

Index  ThresholdName  Status 

CurVal 

LastEvent  LastEventTime 

LastVal 

LastState 

1        envTempOOl  enabled 

33  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

2         envTemp002  enabled 

34  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

3         envTemp003  enabled 

36  C 

ahart-orj             1  fl  ■  9  £  ■  R  Q    r^m    09/01  /9nnn 

n  r 

J.  11  i.  Ul  ILLd  1  LVt; 

4         envTemp004  enabled 

35  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

5         envTemp005  enabled 

36  C 

started        10:28:59  on  02/01/2000 

0  C 

Informative 

1   :  refresh 

9       ■           n  c  ^  V"\  ~1  f^i      ^      i-  Vi  "v"  d  o  Vi  T 
Z      .     U-LoclIJ-Lfc:    CL     LI1X  trfallO-Ld 

3   :  enable  a  threshold 

4   :   advanced  configuration 

5   :   return  to  previous  page 

Select  choice  =>  :    (1..5)  [5] 

switch : admin>  fwconfigure  --disable  --port  1 
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See  also 

fwClassInit 
fwConf igReload 
fwShow 


266   Fabric  OS  commands 


fwFruCfg 


Displays  or  modifies  FRU  state  alert  configuration. 


Synopsis 

fwfrucfg  [--show] 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  configure  FRU  states  and  actions.  Based  on  these  configuration  settings,  Fabric 
Watch  generates  action  when  an  FRU  state  changes.  To  configure  e-mail  alerts,  use  fwMailCf g. 


NOTE:   This  command  is  not  applicable  to  platforms  without  FRUs. 


If  no  operand  is  specified,  the  configuration  prompt  appears. 


Operands 


This  command  has  the  following  operand: 


--show 


Displays  the  current  FRU  configuration  setting. 
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Examples 

To  change  the  FRU  state  alert  configuration: 


switch : admin>  fwfrucfg 

The  current  FRU  configuration: 
Alarm  State 

Alarm  Action 

Slot 

0 

1 

Power  Supply 

0 

0 

Fan 

0 

0 

WWN 

0 

0 

Note  that  the  value  0 

for 

a  parameter  means  that 

it  is  NOT  used  in  the 

cal 

culation 

Configurable  Alarm  St 

ates 

are : 

Absent-1,  Inserted-2, 

On- 

4,  Off-8, 

Faulty-16 

Configurable  Alarm  Ac 

tions  are: 

Errlog-1,  E-mail-16 

Slot  Alarm  State:  (0. 

.31) 

[0]  3 

Slot  Alarm  Action:  (0 

.  .  17 

)  [1] 

Power  Supply  Alarm  St 

ate : 

(0. .31) 

[0] 

Power  Supply  Alarm  Ac 

tion 

:    (0.  .17) 

[0] 

Fan  Alarm  State:  (0.. 

31) 

[0] 

Fan  Alarm  Action:  (0. 

.17) 

[0] 

WWN  Alarm  State:  (0.. 

31) 

[0] 

WWN  Alarm  Action:  (0. 

.17) 

[0] 

Fru  configuration  sue 

cess 

fully  changed 

See  also 

fwConf igure 
fwMailCfg 
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fwHelp 

Displays  Fabric  Watch  command  information. 

Synopsis 

f whelp 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  the  commands  that  configure  Fabric  Watch. 

Operands 

none 

Examples 

To  display  a  summary  of  Fabric  Watch  commands: 


switch :user>  f whelp 


f anShow 

Show  fan  speeds 

fwAlarmsFilterSet 

Configure  alarms  filtering  for  Fabric  Watch 

fwAlarmsFi Iter Show 

Show  alarms  filtering  for  Fabric  Watch 

fwClassInit 

Initialize  all  Fabric  Watch  classes 

fwConf igure 

Configure  Fabric  Watch 

fwConf igReload  Reload 

Fabric  Watch  configuration 

fwFruCf g 

Configure  FRU  state  and  notification 

fwMailCfg 

Configure  Fabric  Watch  Email  Alert 

fwPortDe tail Show 

Create  a  report  with  detailed  port  information 

fwSamShow 

Show  availability  monitor  information 

fwSet 

Set  port  persistence  time 

fwSetToCustom 

Set  boundary  &  alarm  level  to  custom 

fwSetToDefault 

Set  boundary  &  alarm  level  to  default 

fwShow 

Show  thresholds  monitored  or  port  persistence  time 

sensorShow 

Show  sensor  readings 

switchStatusPolicySet 

Set  switch  status  policy  parameters 

switchStatusPolicyShow 

Show  switch  status  policy  parameters 

switchStatusShow 

Show  overall  switch  status 

temp Show 

Show  switch  temp  readings 

See  also 

none 


Fabric  OS  5.x  command  reference  guide  269 


fwMailCfg 

Displays  and  configures  Fabric  Watch  e-mail  alerts. 

Synopsis 

fwmailcf g 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  or  modify  the  configuration  and  status  of  the  Fabric  Watch  e-mail  alert  in  the 
switch. 

Switch  elements  monitored  by  Fabric  Watch  are  divided  into  classes,  and  e-mail  alerts  are  based  on  the 
classes.  Each  class  can  configure  one  e-mail  address  as  the  alert  message's  receiver. 

For  an  e-mail  alert  to  function  correctly,  add  the  CPO  and  CP1  IP  addresses  and  hostname  to  DNS  and 
also  set  the  domain  name  and  name  server.  The  ipAddrShow  and  dnsConf  ig  commands  can  be  used 
to  set  and  check  this  information. 

Operands 

none 

Examples 

To  configure  an  e-mail  settings: 


switch 

admin>  fwmailcfg 

1  : 

Show  Mail  Configuration  Information 

2  : 

Disable  Email  Alert 

3  : 

Enable  Email  Alert 

4  : 

Send  Test  Mail 

5  : 

Set  Recipient  Mail  Address  for  Email  Alert 

6  : 

Quit 

Select  an  item    =>  :    (1..6)    [6]  1 

(continued  on  next  page) 
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Config  Show  Menu 


1 

:  Environment  class 

2 

:   SFP  class 

3 

:   Port  class 

4 

:  Fabric  class 

5 

:  E-Port  class 

6 

:  F/FL  Port   (Optical)  class 

7 
8 

:  Alpa  Performance  Monitor  class 

:  End-to-End  Performance  Monitor  class 

9 

:  Filter  Performance  Monitor  class 

10 

:   Security  class 

11 

:  Resource  class 

12 

:    FRU  Class 

13 

:  Quit 

Select  an  item  =>   :    (0..13)    [11]  1 


mail  configuration  information 


Email  Alert  =  disable 
Mail  Recipients  =  NONE 


1  :   Show  Mail  Configuration  Information 

2  :   Disable  Email  Alert 

3  :  Enable  Email  Alert 

4  :  Send  Test  Mail 

5  :   Set  Recipient  Mail  Address  for  Email  Alert 

6  :  Quit 

Select  an  item  =>   :    (1..6)    [6]  5 
(continued  on  next  page) 
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Mail  Config  Menu 

1  : 

Environment  class 

2  : 

SFP  class 

3  : 

Port  class 

4  : 

Fabric  class 

5  : 

E-Port  class 

6  : 

F/FL  Port    (Optical)  class 

7  : 

Alpa  Performance  Monitor  class 

8  : 

End-to-End  Performance  Monitor  class 

9  : 

Filter  Performance  Monitor  class 

10  : 

Security  class 

12  : 

FRU  Class 

13  : 

Quit 

Select 

an  item  =>   :    (0 . . 13 )    [11]  1 

Mail  To 

:    [NONE]  JoeDoe@bogus.com 

Email  Alert  configuration  succeeded! 

See  also 

fwConf igure 

ipAddrSet 

ipAddrShow 
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f  wPortDeta  i  IShow 

Displays  the  port  information  for  specified  user  ports. 

Synopsis 

fwportdetailshow   [--p  portNumber]    |    [--s  portState] 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  print  the  overall  status  of  the  ports  specified.  The  overall  status  is  calculated  based  on 
the  following  contributors: 


Port  Errors 

LFA  Number  of  link  loss  occurrences  exceeded  limit  for  time  period 

LSY  Number  of  sync  loss  occurrences  exceeded  limit  for  time  period 

LSI  Number  of  signal  loss  occurrences  exceeded  limit  for  time  period 

PER  Number  of  protocol  errors  exceeded  limit  for  time  period 

INW  Number  of  invalid  words  exceeded  limit  for  time  period 

CRC  Number  of  invalid  CRC  errors  exceeded  limit  for  time  period 

PSC  Port  hardware  state  changed  too  often 

BLP  Buffer  limit  port 
SFP  Errors 

STM  SFP  temperature  is  out  of  specification 

SRX  SFP  receive  power  is  out  of  specification 

STX  SFP  transmit  power  is  out  of  specification 

SCU  SFP  current  is  out  of  specification 

SVO  SFP  voltage  is  out  of  specification 

The  overall  status  can  be  in  one  of  the  followings: 

Healthy  Every  contributor  is  healthy 

Marginal  One  or  more  contributors  are  in  this  status 

Faulty  Faulty  hardware 

Offline  Port  has  no  connectivity  or  is  disabled 


If  the  overall  status  is  not  healthy,  the  contributing  factors  also  are  listed. 

Operands 

If  no  operand  is  specified,  all  ports  are  displayed. 
This  command  has  the  following  operands: 
--p  portNumber  Yields  a  port  detail  report  for  a  specific  port. 
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--s  portState  Yields  a  port  detail  report  for  the  specified  portState.  Valid 

portState  entries  are: 

h  Report  based  on  all  healthy  ports 

m  Report  based  on  all  marginal  ports 

f  Report  based  on  all  faulty  ports 

o  Report  based  on  all  offline  ports 

Examples 

To  retrieve  a  port  detail  report: 


switch: 

user> 

fwportdetailshow  --s  h 

Port 

Detail  Report 

Report 

time:   06/07/2004  03: 

:11:44  PM 

Switch  Name:  switch 

IP  address 

:  10. 

,255.255.255 

Port 

Exception  report   [by  Healthy] 

-Port-Errors 

 SFP-Errors  

Port# 

:  Type 

State 

Dur (H:M)    LFA  LSY 

LSI  PER  INW 

CRC  PSC  BLP  STM  SRX 

STX  SCU 

SVO 

000 

E 

HEALTHY 

001: 

:  11 

001 

E 

HEALTHY 

001: 

:  11 

002 

F 

HEALTHY 

001: 

:  11 

003 

F 

HEALTHY 

001: 

:  11 

004 

E 

HEALTHY 

001: 

:  11 

005 

E 

HEALTHY 

001: 

:  11 

006 

E 

HEALTHY 

001: 

:  11 

007 

E 

HEALTHY 

001: 

:  11 

008 

E 

HEALTHY 

001: 

:  11 

009 

F 

HEALTHY 

001: 

:  11 

022 

F 

HEALTHY 

001: 

:  11 

023 

F 

HEALTHY 

001: 

:  11 

024 

E 

HEALTHY 

001: 

:  11 

025 

E 

HEALTHY 

001: 

:  11 

026 

F 

HEALTHY 

001: 

:  11 

027 

F 

HEALTHY 

001: 

:  11 

028 

E 

HEALTHY 

001: 

:  11 

029 

E 

HEALTHY 

001: 

:  11 

031 

F 

HEALTHY 

001: 

:  11 

(continued  on  next  page) 
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switch: 

user> 

fwportdetailshow  --s  h 

Port 

Detail  Report 

f-imo'   nfi  /  m  /  9nn/i  m- 

■  11  -  A  A  DM 

Switch  Name:  switch 

IP  address 

:  10 

.255 .255 .255 

Port 

Exception  report   [by  Healthy] 

-Port-Errors 

 SFP-Errors  

:  Type 

Of-  a  f-  o 

Dur ( H : M)    LFA  LSY 

LSI  PER  INW 

CRC  PSC  BLP  STM  SRX 

STX  SCU 

SVO 

000 

E 

HEALTHY 

001: 

:  11 

001 

E 

HEALTHY 

001: 

:  11 

002 

F 

HEALTHY 

001: 

:  11 

003 

F 

HEALTHY 

001: 

:  11 

004 

E 

HEALTHY 

001: 

:  11 

005 

E 

HEALTHY 

001: 

:  11 

006 

E 

HEALTHY 

001: 

:  11 

007 

E 

HEALTHY 

001: 

:  11 

008 

E 

HEALTHY 

001: 

:  11 

009 

F 

HEALTHY 

001: 

:  11 

022 

F 

HEALTHY 

001: 

:  11 

023 

F 

HEALTHY 

001: 

:  11 

024 

E 

HEALTHY 

001: 

:  11 

025 

E 

HEALTHY 

001: 

:  11 

026 

F 

HEALTHY 

001: 

:  11 

027 

F 

HEALTHY 

001: 

:  11 

028 

E 

HEALTHY 

001: 

:  11 

029 

E 

HEALTHY 

001; 

:  11 

031 

F 

HEALTHY 

001: 

:  11 

See  also 

switchStatusShow 
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fwSamShow 

Displays  switch  availability  monitor  information. 

Synopsis 

fwsamshow 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  information  about  port  availability.  The  information  displayed  includes  total 
uptime,  total  downtime,  number  of  faulty  occurrences,  and  total  percent  of  downtime  for  each  port. 

Operands 

none 

Examples 

To  display  port  summary  information  on  an  eight  port  switch: 


switch: user > 

fwsamshow 

Total 

Total 

Down 

Total 

Port# 

Type 

Up  Time 

Down  Time 

Occurrence 

Offline  Time 

(Percent) 

(Percent) 

(Times) 

(Percent) 

0 

U_PORT 

0 

0 

0 

100 

1 

U_PORT 

0 

0 

0 

100 

2 

U_PORT 

0 

0 

0 

100 

3 

E_PORT 

21 

0 

0 

78 

4 

E_PORT 

20 

0 

0 

80 

5 

U_PORT 

0 

0 

0 

100 

6 

U_PORT 

0 

0 

0 

100 

7 

U_PORT 

0 

0 

0 

100 

See  also 

portShow 
switchShow 
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fwSet 

Sets  the  parameters  controlled  by  Fabric  Watch. 

Synopsis 

fwset   [--port  --persistence  seconds] 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  set  parameters  controlled  by  Fabric  Watch.  It  allows  the  user  to  set  the  port 
persistence  time  (time  in  which  a  port  must  persistently  be  in  a  marginal  state  before  being  labeled 
as  such) 

Operands 

The  operand  is  as  follows: 

--port  --persistence  seconds     Set  port  parameters.  Currently  only  port  persistence  time 

can  be  set  with  this  option.  Port  persistence  time  is  the  time 
period  in  which  a  port  must  be  persistently  in  a  state  before 
being  actually  being  recognized  as  such. 

Examples 

To  set  message  levels  and  port  persistence  time: 

switch:user>  fwset  --port  --persistence  18 

See  also 

fwShow 
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fwSetToCustom 


Sets  boundary  and  alarm  levels  to  custom  values. 

Synopsis 


fwsettocustom 


Availability 

admin 


122)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  set  boundary  and  alarm  levels  to  custom  values  for  all  classes  and  areas  in  Fabric 
Watch. 

Operands 

none 

Examples 

To  set  alarm  levels  to  custom  values: 

switch : admin>  fwsettocustom 
Committing  configuration ...  done . 

See  also 

fwSetToDefault 


278   Fabric  OS  commands 


fwSetToDefault 


Returns  boundary  and  alarm  levels  to  the  default  values. 


Synopsis 

fwsettodef ault 

Availability 

admin 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  return  boundary  and  alarm  levels  to  defaults  for  all  classes  and  areas  in  Fabric 
Watch. 

Operands 

none 


Examples 


To  return  alarm  levels  to  default  values: 


switch : admin>  fwsettodef ault 


Committing  configuration ...  done . 


See  also 


fwSetToCustom 
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fwShow 

Displays  the  thresholds  monitored  by  Fabric  Watch. 

Synopsis 

fwshow   [--port  --persistence]    |    [--disable  --port] 

Availability 

all  users 


\^)f  NOTE:   This  command  requires  a  Fabric  Watch  license. 


Description 

Use  this  command  to  display  the  thresholds  monitored  by  Fabric  Watch.  This  command  also  displays  the 
port  persistence  time  and  ports  with  all  thresholds  disabled. 

Operands 

The  operands  are  as  follows: 

--port  --persistence       Displays  the  time  that  a  port  must  be  persistently  in  a  state  before 

being  marked  as  such. 

--disable  --port  Displays  the  ports  that  have  all  associated  thresholds  disabled. 

Examples 

To  display  thresholds  and  port  persistence  time: 


switch 

user>  fwshow 

1  : 

Show  class  thresholds 

2  : 

Detail  threshold  information 

3  : 

Show  console  message  level 

4  : 

Show  port  persistence  time 

5  : 

Quit 

Select  an  item    =>   :    (1..3)    [3]  1 

1  : 

Environment  class 

2  : 

SFP  class 

3  : 

Port  class 

4  : 

Fabric  class 

5  : 

E-Port  class 

6  : 

F/FL  Port   (Optical)  class 

7  : 

Alpa  Performance  Monitor  class 

8  : 

End-to-End  Performance  Monitor  class 

9  : 

Filter  Performance  Monitor  class 

(continued  on  next  page) 
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10   :   Security  class 

11   :  Resource  class 

12    :  Quit 

Select  an  item    =>  :    (1..12)    [11]  1 

_L       .        X  Cl  L  LfcJ  C  -L  CI      l__  -1-  C 

2    •  Fan 

3    :   Power  Supply 

4   :   return  to  previous  page 

Select  an  area  =>   :    (1.-4)    [4]  2 

Name                            Label  Last 

value 

envFanOOl                         Env  Fan  1 

2576 

RPM 

envFan002                          Env  Fan  2 

2518 

RPM 

envr  an uuj                             Jin v  r  an  j 

0  A  P  1 
Z     O  -L 

"P  DM 

C^TaT  n                         ■  1  1  t~  ^  "V  ^*         ~T~  T»T  C  Vl  ^TaT 

J.         .     OIlUW    Lldbo     LUX  tifcillU lUb 

__          .      UfcrLct-L-L     UIl-LfcioIiU-LU.     -LIl  __l_>__  It  Lei  1  L  UI1 

"3          ■      QVi  i^tit    i^i^"noi~\T  o    Tnooc!3(~fi2     "1  enrol 
O         .     OliUW    L-U-Llo  U  J.  t:    llltdooctyt;  level 

4     :   Show  port  persistence  time 

5      :  Quit 

Select  an  item    =>   :    (1..3)    [3]  2 

Enter  Threshold  Name   :    []  envFanOOl 

Env  Temperature  1 : 

Monitored  for:               1283    (21  mins) 

Ldsu  cnecKeo.        j_u.ou.zx  on  uz  /  U-L/ z  uuu 

Lower  bound:                    0  C 

Upper  bound:                  7  5  C 

Buffer  Size:  10 

Value  history:                  33  C 

Disabled?  No 

Locked?  No 

(continued  on  next  page) 
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Raw  history:                  3  8  C 

JO 

JO  L_ 

t?1         -    n-v-               /in  rni?Trir,T?DTP'n 

r  .LaCjo  .      UX                    L±  U  lK±^jkjJljKJiiJ 

Counter : 

Access  via:   Function  call 

Address :  0xl00155a8 

Previous:   0x00000026  (38) 

Lur r enu .    uxuuuuuu/o    i jo j 

Events : 

Diyic  .    iiiyyt;!  tiu. 

Event  0  occurred  1  time ,    last  at 

16 

:30 

:  17 

on  12/09/2011 

Event  1  occurred  10  times,  last 

at 

16  : 

49  : 

02  on  12/09/2011 

*  Event  5  occurred  1  t ime ,    last  at 

.  J  u 

.  Z  j 

on    1// U"/ ZUll 

Callbacks : 

1NU    L-cLX  J-SJcL^  Jvfci    ale  icyibUcieu. 

switch:user>  fwshow  --port  --persistence 

rvV.      CU--L-Lc:IlL-    pUI  U    jJfc!-LO-LoLc:IlC<d     LllllC     —     J_  O  Jo 

switch :user>  fwshow  — port  — persistence 

FW:   current  port  persistence  time  =  18s 

switch:user>  fwShow  --disable  --port 

Port          Threshold  Status 

1  disabled 

See  also 

fwClassInit 
fwConf igReload 
fwConf igure 
fwSet 
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Displays  shell  history. 

Synopsis 

h 

Availability 

all  users 

Description 

Use  this  command  to  view  the  shell  history.  The  shell  history  mechanism  is  similar  to  the  UNIX  Korn  shell 
history  facility.  It  has  a  built-in  line  editor  similar  to  UNIX  vi  that  enables  previously  typed  commands  to  be 
edited.  The  h  command  displays  the  20  most  recent  commands  typed  into  the  shell;  the  oldest  commands 
are  replaced  as  new  ones  are  entered. 

To  edit  a  command,  press  ESC  to  access  edit  mode  and  then  use  vi  commands.  The  ESC  key  switches  the 
shell  to  edit  mode.  The  ENTER  key  gives  the  line  to  the  shell  from  either  editing  or  input  mode. 

Basic  vi  commands  are  as  follows: 


k 

Move  the  cursor  up 

j 

Move  the  cursor  down 

h 

Move  the  cursor  left 

1 

Move  the  cursor  right 

a 

Append 

i 

Insert 

X 

Delete 

u 

Undo 

Operands 

none 

Examples 

To  display  previous  shell  commands: 

switch : admin>  h 

1  version 

2  switchshow 

3  portdisable  2 

4  portenable  2 

5  switchshow 

See  also 

none 
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haDisable 

Disables  the  High  Availability  feature  in  the  switch. 

Synopsis 

hadisable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  High  Availability  feature  in  the  switch.  If  the  HA  feature  is  already 
disabled,  this  command  does  nothing. 

Operands 

none 

Examples 

To  disable  the  High  Availability  feature: 

switch : admin>  hadisable 
HA  is  disabled 

See  also 

haEnable 
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haDump 

Displays  information  about  the  status  of  the  High  Availability  feature  in  the  switch. 

Synopsis 

hadump 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  the  status  of  the  High  Availability  feature  in  the  switch.  This 
command  displays  the  following  information: 

•  Local  CP  state  (slot  number  and  CP  ID) 

•  Remote  CP  state  (slot  number  and  CP  ID) 

•  High  Availability  enabled/disabled 
Heartbeat  up/down 

•  Health  of  standby  CP: 

Healthy  The  standby  CP  is  running  and  the  background  health  diagnostic 

has  not  detected  any  errors. 

Failed  The  standby  CP  is  running,  but  the  background  health  diagnostic 

has  discovered  a  problem.  Failover  is  disabled  until  the  standby 
CP  is  repaired.  The  information  of  the  failing  device  in  the 
standby  CP  is  displayed. 

Unknown  The  standby  CP  healthy  state  is  unknown  due  to  not  existing, 

heartbeat  is  down,  or  healthy  monitor  detects  a  configuration  file 
error. 

•  HA  synchronization  status: 

HA  State  Synchronized      The  system  is  currently  fully  synchronized.  If  a  failover  became 

necessary,  it  would  be  nondisruptive. 

HA  State  Not  In  Sync        The  system  is  unable  to  synchronize  the  two  CPs,  due  to  a  faulty 

standby  CP  or  another  system  error.  If  a  failover  becomes 
necessary  at  this  time,  the  standby  CP  reboots,  causing  a 
disruptive  failover. 

•  IP  and  Fibre  Channel  addresses  configured  for  the  switch. 

•  Additional  internal  HA  state  information,  subject  to  change. 

Operands 

none 
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Examples 

To  view  information  about  the  High  Availability  feature: 


switch : admin>  hadump 

hashow: 

Local  CP   (Slot  6,   CP1) :  Active 

Remote  CP   (Slot  5,  CPO): 

Standby,  Healthy 

HA  enabled,  Heartbeat  Up, 

HA 

State  synchronized 

ipaddrshow: 

SWITCHO 

Ethernet  IP  Address:  10.6 

4  . 11 

8.104 

Ethernet  Subnetmask:  255. 

o  c  c 
ZDD  . 

z4U  .  U 

Fibre  Channel  IP  Address : 

0  .  0 

.0.0 

Fibre  Channel  Subnetmask: 

0.0 

.0.0 

SWITCH1 

Ethernet  IP  Address:  10.6 

4  . 11 

8.105 

Ethernet  Subnetmask:  255. 

255  . 

240  .  0 

Fibre  Channel  IP  Address : 

0.0 

.0.0 

Fibre  Channel  Subnetmask: 

0.0 

.0.0 

(output  truncated) 

See  also 

haFailover 
haShow 
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haEnable 

Enables  the  High  Availability  feature  in  the  switch. 

Synopsis 

haenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  High  Availability  feature  in  the  switch.  If  the  HA  feature  is  already 
enabled,  this  command  does  nothing. 

Operands 

none 

Examples 

To  enable  the  High  Availability  feature  in  the  switch: 

switch : admin>  haenable 
HA  is  enabled 

See  also 

haDisable 
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ha  Fa  i  lover 


Forces  the  failover  mechanism  so  that  the  standby  control  processor  (CP)  becomes  the  active  CP. 


Use  this  command  to  force  the  failover  mechanism  to  occur  so  that  the  standby  CP  becomes  the  active  CP. 
Because  haFailover  results  in  an  active  CP  reboot,  a  warning  message  and  confirmation  are 
displayed.  If  the  user  confirms,  the  failover  takes  place. 

When  HA  synchronization  is  enabled  and  the  CPs  are  in  sync,  the  port  traffic  light  does  not  flash  during 
the  failover,  even  while  traffic  is  continuing  to  flow. 


NOTE:    This  command  is  supported  only  on  systems  with  dual  CP  cards. 


Operands 

none 

Examples 

To  force  the  failover  of  the  active  CP  to  the  standby  CP  in  the  switch: 


switch : admin>  hafailover 

Local  CP   (Slot  6,   CP1) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Healthy 

HA  enabled,  Heartbeat  Up,  HA  State  synchronized 

Warning:  This  command  is  being  run  on  a  redundant  control 
processor (CP)   system.   If  the  above  status  does  not  indicate 
'HA  State  synchronized',   then  the  CPs  are  not  synchronized 
and  this  operation  will  cause  the  active  CP  to  reset.  This 
will  cause  disruption  to  devices  attached  to  both  switch  0 
and  switch  1  and  will  require  that  existing  telnet  sessions 
be  restarted.  To  reboot  a  single  logical  switch  on  this 
system,   use  the  switchreboot  command  while  logged  in  to 
that  logical  switch. 

Are  you  sure  you  want  to  fail  over  to  the  standby  CP   [y/n] ?  y 


Synopsis 


hafailover 


Availability 


admin 


Description 


See  also 


haDisable 

haEnable 

haShow 
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haShow 

Displays  control  processor  (CP)  status. 

Synopsis 

hashow 

Availability 

all  users 

Description 

Use  this  command  to  display  control  processor  status,  which  includes: 

•  Local  CP  state  (slot  number  and  CP  ID) 

•  Remote  CP  state  (slot  number  and  CP  ID) 

•  High  Availability  enabled/disabled 
Heartbeat  up/down 

•  Health  of  standby  CP: 

Healthy  The  standby  CP  is  running  and  the  background  health  diagnostic 

has  not  detected  any  errors. 

Failed  The  standby  CP  is  running,  but  the  background  health  diagnostic 

has  discovered  a  problem  with  the  blade.  The  logs  should  be 
checked  to  determine  the  appropriate  repair  action.  Failover  is 
disabled  until  the  standby  CP  is  repaired. 

Unknown  The  standby  CP  healthy  state  is  unknown  due  to  not  existing, 

heartbeat  is  down,  or  healthy  monitor  detects  a  configuration  file 
error. 

•  HA  synchronization  status: 

HA  State  Synchronized      The  system  is  currently  fully  synchronized.  If  a  failover  became 

necessary,  it  would  be  nondisruptive. 

HA  State  Not  In  Sync        The  system  is  unable  to  synchronize  the  two  CPs,  due  to  the 

standby  CP  being  faulty  or  another  system  error.  If  a  failover 
became  necessary,  at  this  time,  the  standby  CP  reboots,  and  the 
failover  is  disruptive. 


'2^Jj?  NOTE:    This  command  might  not  be  supported  on  nonbladed  systems. 


Operands 

none 
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Examples 

To  display  CP  status: 

switch : admin>  hashow 

Local  CP   (Slot  6,   CP1) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Healthy 

HA  Enabled,  Heartbeat  Up,  HA  State  Synchronized 

switch : admin>  hashow 

Local  CP   (Slot  6,   CP1) :  Active 

Remote  CP   (Slot  5,   CPO) :   Standby,  Failed 

Backplane  PCI  fail,   severity:  CRITICAL 
HA  enabled,  Heartbeat  Up,  HA  State  not  in  sync 

See  also 

haDisable 

haEnable 

haFailover 
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haSyncStart 

Enables  HA  state  synchronization. 

Synopsis 

hasyncstart 

Availability 

admin 

Description 

Use  this  command  to  enable  the  HA  state  synchronization. 

Operands 

none 

Examples 

To  enable  the  HA  state  synchronization: 

switch : admin>  hasyncstart 

HA  State  synchronization  has  started 

See  also 

haFailover 

haShow 

haSyncStop 
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haSyncStop 

Disables  the  HA  state  synchronization. 

Synopsis 

hasyncstop 

Availability 

admin 

Description 

Use  this  command  to  temporarily  disable  the  HA  synchronization.  The  next  fa i lover  that  takes  place  after 
might  be  disruptive. 

Operands 

none 

Examples 

To  disable  the  HA  state  synchronizing  process: 

switch : admin>  hasyncstop 

See  also 

haFailover 

haShow 

haSyncStart 
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help 

Displays  help  information  for  commands. 

Synopsis 

help    [ command] 

Availability 

all  users 

Description 

Use  this  command  without  a  operand  to  display  an  alphabetical  list  of  individual  commands.  At  the  end 
of  the  list  are  commands  that  display  groups  of  commands;  for  example,  diagShow  displays  a  list  of 
diagnostic  commands. 

The  list  displays  only  commands  that  are  available  to  the  current  user;  this  can  vary,  according  to: 

•  Login  user  level 

•  License  key 

•  Switch  model 

To  access  help  information  for  a  specific  command,  enter  the  command  name  as  an  operand. 
Operands 

This  command  has  the  following  optional  operand: 
command  Specify  the  command  name,  with  or  without  quotation  marks. 

Examples 

To  display  help  information  for  the  passwd  command: 

switch :admin>  help  passwd 

See  also 

diagHelp 

fwHelp 

licenseHelp 

perf Help 

routeHelp 

zoneHelp 
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history  LastShow 

Displays  the  latest  entry  in  the  field  replaceable  unit  (FRU)  history  log. 

Synopsis 

hi story last show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  contents  of  the  latest  history  log  record.  A  history  record  contains  three 
lines  of  information.  The  first  line  of  each  record  contains  the  following  data  sets: 


Object  type 


CHASSIS,  FAN,  POWER  SUPPLY,  SW  BLADE  (port  blade),  CP 
BLADE  (control  processor),  WWN  (world  wide  name  card),  or 


UNKNOWN. 


Object  number 
Event 

Time  of  the  event 


Slot  number  for  blades  and  unit  number  for  everything  else. 
Inserted,  Removed,  or  Invalid, 
at  Day  Mon  dd  hh:mm:ss  yyyy 


The  second  and  third 
lines  of  a  record  each 
contain  one  data  set, 
preceded  by  its  name: 

Factory  Part  Number 

Factory  Serial  Number 


xx-yyyyyyy-zz  or  Unknown 
xxxxxxxxxxxx  or  Unknown 


Operands 


none 


Examples 


To  display  the  late  FRU  insertion  or  removal  event: 


switch : admin>  historylastshow 


POWER  SUPPLY     Unit  2 


Inserted  at  Tue  Aug  14  15:52:10  2001 


Factory  Part  Number: 


60-0001536-02 


Factory  Serial  Number:  1013456800 


Records : 


11 


See  also 


historyShow 
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historyMode 


Displays  the  mode  of  the  history  log. 


Synopsis 

historymode 

Availability 

all  users 

Description 

Use  this  command  to  display  the  mode  of  the  history  buffer: 


Operands 

none 

Examples 

To  change  the  history  mode  to  first-in  from  rotating: 


Rotating  mode 
First-in  mode 


New  messages  overwrite  the  oldest  messages  in  the  log. 

Once  the  log  is  full,  all  additional  logs  are  discarded  so  that  the 
first  set  of  logs  to  fill  the  buffer  are  preserved. 


switch : admin>  historymode 


History  Mode  is:  Rotating. 


See  also 


historyLastShow 


historyShow 
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historyShow 

Displays  the  entire  field  replaceable  unit  (FRU)  history  log. 

Synopsis 

historyshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  entire  history  log,  which  records  insertion  and  removal  events  for  blades, 
power  supplies,  fans,  and  world  wide  name  (WWN)  cards.  Each  history  record  contains  three  lines  of 
information.  The  first  line  of  each  record  contains  the  following: 

Object  type  CHASSIS,  FAN,  POWER  SUPPLY,  SW  BLADE  (port  blade),  CP 

BLADE  (control  processor),  WWN  (WWN  card),  or 
UNKNOWN 

Object  number  Slot  number  for  blades  and  unit  number  for  everything  else. 

Event  type  Inserted,  Removed,  or  Invalid 

Time  of  the  event  Format:  Day  Mon  dd  hh:mm:ss  yyyy 

The  second  and  third  lines  of  a  record  respectively  contain  the  factory  part  number  and  factory  serial 
number,  if  applicable: 

Factory  Part  Number  xx-yyyyyyy-zz  or  Unknown 

Factory  Serial  Number  xxxxxxxxxxxx  or  Unknown 

Operands 

none 
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Examples 

To  display  the  entire  contents  of  the  history  file: 


switch : admin>  historyshow 

FAN    Unit  3 

Removed  at  Tue  Aug 

14 

10: 

05: 

37 

1970 

Factory  Part  Number: 

On      1  O  O  /I  C  £T  "IT 

zU-±zj4oo-±z 

Factory  Serial  Number: 

1U lo  4o  oo  UU 

POWER  SUPPLY    Unit  1 

Inserted  at  Tue  Aug 

14 

10 

:52 

:  10 

1970 

Factory  Part  Nuitiber: 

60-0U01536-U2 

Factory  Serial  Number: 

Not  Available 

FAN    Unit  3 

Inserted  at  Tue  Aug 

14 

10 

:23 

:45 

2001 

Factory  Part  Number: 

20-123456-12 

Factory  Serial  Number: 

1013456800 

WWN    Unit  1 

Inserted  at  Tue  Aug 

14 

11 

:03 

:45 

2001 

Factory  Part  Number: 

40-0000031-03 

Factory  Serial  Number: 

1013456800 

(output  truncated) 

SW  BLADE     Slot  3 

Removed  at  Tue  Aug 

14 

12  : 

10  : 

09 

2001 

Factory  Part  Number: 

oU -U  UU loiz -Uo 

Factory  Serial  Number: 

±  U lo  4o  bo  UU 

CP  BLADE     Slot  6 

Removed  at  Tue  Aug 

14 

13  : 

45: 

07 

2001 

Factory  Part  Number: 

c  r\    n  c\  n  1  c.  c\  a  nn 
dU-UUU1dU4-(Jz 

Factory  Serial  Number: 

FPUUXbUUlzo 

SW  BLADE     Slot  3 

Inserted  at  Tue  Aug 

14 

13 

:53 

:40 

2001 

Factory  Part  Number: 

d0-0U01d3z-U3 

Factory  Serial  Number: 

101345ooUU 

CP  BLADE     Slot  6 

Inserted  at  Tue  Aug 

14 

13 

:59 

:50 

2001 

Factory  Part  Number : 

60-0001604-02 

Factory  Serial  Number: 

FP00X600128 

POWER  SUPPLY     Unit  2 

Inserted  at  Tue  Aug 

14 

15 

:52 

:  10 

2001 

Factory  Part  Number : 

60-0001536-02 

Factory  Serial  Number: 

1013456800 

Records:  11 
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See  also 

historyLastShow 
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httpCfgShow 

Displays  the  Java™  plug-in  version. 

Synopsis 

httpcf gshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  version  of  the  Java  plug-in  supported  by  Web  Tools.  This  command  also 
displays  the  URL  from  which  the  plug-in  can  be  downloaded. 

Operands 

none 

Examples 

To  display  the  Java  plug-in  version: 

switch : admin>  httpcf gshow 
Current  HTTP  configuration 
javaplugin. version  =  1,3,1 

javaplugin. homeURL  =  http://java.sun.com/products/plugin 

See  also 

none 
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Displays  a  task  summary. 


Synopsis 


i  [processID] 


Availability 

all  users 


Description 

Use  this  command  to  display  information  about  all  of  the  processes  or  about  a  specific  process  (if  a 
process  ID)  is  supplied.  One  line  is  displayed  per  process.  Fields  displayed  with  this  commands  include 
those  shown  in  Table  1 4. 

Table  14    i  command  field  descriptions 


Field 

Description 

c 

r 

Process  flags: 

ALIGNWARN 

001 

print  alignment  warning  messages 

STARTING 

002 

being  created 

EXITING 

004 

getting  shut  down 

PTRACED 

010 

set  if  ptrace  (0)  has  been  called 

TRACESYS 

020 

tracing  system  calls 

FORKNOEXEC 

040 

forked  but  did  not  exec 

SUPERPRIV 

100 

used  super-user  privileges 

DUMPCORE 

200 

dumped  core 

SIGNALED 

400 

killed  by  a  signal 

s 

Process  state  coc 

es: 

D  uninterruptibl 

e  sleep 

(usually  IO) 

R    runnable  (on 

run  queue) 

S  sleeping 

T   traced  or  stopped 

Z   a  defunct  ("zombie") 

process 

UID 

The  effective  user 

ID  num 

ber  of  the  process 

PID 

The  process  ID  of  the  process 

PPID 

The  process  ID  of  the  parent  process 

C 

Processor  utilization  for  scheduling 

PRI 

Priority  number  of  the  process;  higher  numbers  mean  lower  priority 

Nl 

Nice  value  used 

'n  priority  computation 
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Table  14    i  command  field  descriptions  (continued) 


Field 

Description 

ADDR 

Memory  address  of  the  process 

SZ 

Tl          1     1      1                       f  il                                                 ■    L  1 

me  total  size  ot  the  process  in  virtual  memory,  in  pages 

\  A  If  NAM 

WCHAN 

ti          il            r                 .  r         i  •  i                          1        •       /•£  II  1 

The  address  ot  an  event  tor  which  process  is  sleeping  (it  blank,  process  is 
running) 

TTY 

The  controlling  terminal  of  the  process  (?  printed  for  no  controlling  terminal) 

TIME 

The  cumulative  execution  time  for  the  process 

CMD 

The  command  name  of  the  process 

Operands 

This  command  has  the  following  operand: 

processlD  Specify  the  process  name  or  process  ID  for  the  process  to 

display. 

Examples 

To  display  information  about  process  ID  433: 


switch 

admin> 

i  433 

F  S 

UID 

PID  PPID 

C  PRI 

NI  ADDR  SZ 

WCHAN 

TTY 

TIME 

CMD 

000  s 

0 

433  1 

0  69 

0         -  1283 

5c64  ? 

00 

00  :  02 

f abricd 

See  also 

diagHelp 
routeHelp 
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ifModeSet 


Sets  the  link  operating  mode  for  a  network  interface. 

Synopsis 

ifmodeset   ["interface"  ] 

Availability 

admin 

Description 

Use  this  command  to  set  the  link  operating  mode  for  a  network  interface. 

An  operating  mode  is  confirmed  with  a  y  or  yes  at  the  prompt.  If  the  operating  mode  selected  differs 
from  the  current  mode,  the  change  is  saved  and  the  command  exits. 

Changing  the  link  mode  is  not  supported  for  all  network  interfaces  or  for  all  Ethernet  network  interfaces. 
This  command  is  only  functional  for  the  ethO  interface. 

When  selecting  auto-negotiation,  you  can  choose  the  specific  link  operating  modes  that  are  advertised  to 
the  link  partner.  At  least  one  common  link  operating  mode  must  be  advertised  by  both  sides  of  the  link. 

When  forcing  the  link  operating  mode,  both  sides  of  the  link  must  be  forced  to  the  exact  same  mode.  The 
link  does  not  work  reliably  if  one  side  is  set  to  auto-negotiate  and  the  other  side  is  set  to  forced  mode. 

Exercise  care  when  using  this  command.  Forcing  the  link  to  an  operating  mode  not  supported  by  the 
network  equipment  to  which  it  is  attached  might  result  in  an  inability  to  communicate  with  the  system 
through  its  Ethernet  interface.  It  is  recommended  that  this  command  only  is  used  from  the  serial  console 
port.  When  used  through  an  interface  other  than  the  serial  console  port,  the  command  displays  a  warning 
message  and  prompts  the  user  to  for  verification  before  continuing,  this  warning  is  not  displayed  and  the 
user  is  not  prompted  when  the  command  is  used  through  the  serial  console  port. 

For  dual-CP  systems,  the  ifModeSet  command  affects  the  CP  that  you  are  currently  logged  in  to.  To  set 
the  link  operating  mode  on  the  active  CP,  you  must  issue  this  command  on  the  active  CP;  to  set  the  link 
operating  mode  on  the  standby  CP,  you  must  issue  this  command  on  the  standby  CP.  During  failover,  the 
link  operating  mode  is  retained  separately  for  each  CP,  because  the  physical  links  might  be  set  to  operate 
in  different  modes. 


r2^>  NOTE:  This  command  is  not  supported  on  the  HP  StorageWorks  SAN  Switch  4/32  switch  and  HP 
t— I    StorageWorks  SAN  Director  2/1  28  and  4/256  directors  that  use  a  Broadcom  PHY  transceiver. 


Operands 

This  command  has  the  following  operand: 

interface  Specify  the  name  of  the  interface.  You  can  specify  the  name  with 

quotation  marks,  but  using  them  is  not  required.  For  example, 
you  can  use  either  ethO  or  "ethO",  where  eth  is  the  network 
interface  and  0  is  the  physical  unit. 
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Examples 

To  advertise  all  modes  of  operation,  when  not  entering  this  command  through  the  serial  console  port, 
follow  this  scenario  for  the  ifModeSet  command: 

switch : admin>  ifmodeset  ethO 

Exercise  care  when  using  this  command.     Forcing  the  link  to 
an  operating  mode  not  supported  by  the  network  equipment  to 
which  it  is  attached  may  result  in  an  inability  to 
communicate  with  the  system  through  its  ethernet  interface. 

It  is  recommended  that  you  only  use  this  command  from  the 
serial  console  port. 

Are  you  sure  you  really  want  to  do  this?    (yes,   y,   no,   n) :    [no]  y 
Proceed  with  caution. 

Auto-negotiate   (yes,   y,   no,   n) :    [no]  y 

Advertise  100  Mbps  /  Full  Duplex   (yes,  y,   no,   n) :    [yes]  y 
Advertise  100  Mbps  /  Half  Duplex   (yes,  y,   no,   n) :    [yes]  y 
Advertise  10  Mbps  /  Full  Duplex   (yes,   y,   no,   n) :    [yes]  y 
Advertise  10  Mbps  /  Half  Duplex   (yes,   y,   no,   n) :    [yes]  y 
Committing  configuration ...  done . 

To  force  the  link  for  the  ethO  interface  from  auto-negotiation  to  10  Mbit/sec  half-duplex  operation,  when 
entering  this  command  through  the  serial  console  port: 


switch : admin>  ifModeSet  ethO 

Auto-negotiate   (yes,  y,  no,  n) :  [yes] 

n 

Force  100  Mbps  /  Full  Duplex   (yes,  y, 

no , 

.  n) 

:    [no]  n 

Force  100  Mbps  /  Half  Duplex   (yes,  y, 

no , 

.  n) 

:    [no]  n 

Force  10  Mbps  /  Full  Duplex   (yes,  y, 

no, 

n)  : 

[no]  n 

Force  10  Mbps  /  Half  Duplex   (yes,  y, 

no, 

n)  : 

[no]  y 

Committing  configuration ...  done . 

See  also 

ifModeShow 
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ifModeShow 

Displays  the  link  operating  mode  for  a  network  interface. 

Synopsis 

ifmodeshow  [interface] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  link  operating  mode  for  a  network  interface. 

Operands 

This  command  has  the  following  operand: 

interface  Specify  the  name  of  the  interface.  You  might  specify  the  name 

with  quotation  marks,  but  using  them  is  not  required.  For 
example,  you  can  use  either  ethO  or  "ethO",  where  eth  is 
the  network  interface  and  0  is  the  physical  unit. 

Examples 

To  display  the  link  operating  mode  for  the  ethO  Ethernet  interface: 

switch : admin>  ifmodeshow  ethO 

Link  mode:  negotiated  lOObaseTx-HD,   link  ok 

See  also 

ifModeSet 
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interfaceShow 


Displays  FSPF  interface  information. 


Synopsis 


interf aceshow   [ slotnumber/]  [portnumber] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  two  data  structures  associated  with  FSPF  interfaces  (E_Ports)  on  the 
switch : 

•    The  permanently  allocated  Interface  Descriptor  Block  (IDB). 

The  neighbor  data  structure.  This  data  structure  is  allocated  when  a  switch  port  becomes  an  E_Port.  The 
neighbor  data  structure  contains  all  the  information  relating  to  the  switch  that  is  connected  to  an 
adjacent  switch. 

This  command  displays  the  content  of  both  data  structures,  if  they  have  been  allocated. 
The  following  fields  are  displayed: 


idbP 

nghbP 

ifNo 

masterPort 

defaultCost 

cost 

delay 

lastScn 

lastScnTime 

upCount 

lastUpTime 

downCount 

lastDownTime 

downReason 

iState 
state 


Pointer  to  IDB. 

Pointer  to  neighbor  data  structure. 
Interface  number. 

Port  number  of  the  trunk  master  port,  if  present,  of  the  trunk 
group  of  which  this  port  is  a  part. 

Default  cost  of  sending  a  frame  over  the  ISL  connection  to  this 
interface. 

Cost  of  sending  a  frame  over  the  ISL  connected  to  this  interface. 
A  value  of  1000  indicates  a  1-Gb/sec  link.  A  value  of  500 
indicates  a  2-Gb/sec  link. 

Conventional  delay  incurred  by  a  frame  transmitted  on  this  ISL. 
A  fixed  value  required  by  the  FSPF  protocol. 

Type  of  the  last  State  Change  Notification  received  on  this 
interface. 

Time  the  last  State  Change  Notification  was  received  on  this 
interface. 

Number  of  times  this  interface  came  up,  with  respect  to  FSPF. 
Last  time  this  interface  came  up. 
Number  of  times  this  interface  went  down. 
Last  time  this  interface  went  down. 

Type  of  last  State  Change  Notification  that  caused  this  interface 
to  go  down. 

Current  state  of  this  interface.  The  state  can  be  UP  or  DOWN. 
An  interface  in  DOWN  state  does  not  have  an  allocated 
neighbor  data  structure  and  cannot  be  used  to  route  traffic  to 
other  switches. 

Current  state  of  this  interface.  This  E_Port  is  used  to  route  traffic 
to  other  switches  only  if  the  state  is  NB_ST_FULL. 
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nghbCap 

nghbld 

idbNo 

rem  Port 

nflags 

initCount 

lastlnit 
firstHlo 
nbstFull 

&dbRetransList 
&lsrRetransList 
&lsrAckList 

inactTID 

helloTID 

dbRtxTID 

IsrRtxTID 

inactTo 


helloTo 
rXmitTo 

nCmdAcc 
nlnvCmd 

nHloln 
nlnvHlo 

nLsuIn 
nLsaln 
attHloOut 

nHloOut 
attLsuOut 

nLsuOut 
attLsaOut 

nLsaOut 


Neighbor  capabilities.  Should  be  0. 

Domain  ID  of  the  neighbor  (adjacent)  switch. 

IDB  number.  Should  be  equal  to  port  number. 

Port  number  on  the  remote  switch  connected  to  this  port. 

Internal  FSPF  flags. 

Number  of  times  this  neighbor  was  initialized  without  the 
interface  going  down. 

Time  the  last  initializing  state,  NB_ST_INIT,  on  this  interface. 

Time  the  first  hello  sent  on  this  interface. 

Time  the  last  finishing  state,  NB_ST_FULL,  on  this  interface. 

Pointer  to  the  database  retransmission  list. 

Pointer  to  the  Link  State  Records  (LSR)  retransmission  list. 

Pointer  to  the  Link  State  Acknowledgements  (LSA)  retransmission 
list. 

Inactivity  timer  ID. 
Hello  timer  ID. 

Database  retransmission  timer  ID. 
LSR  retransmission  timer  ID. 

Inactivity  timeout  value,  in  milliseconds.  When  this  timeout 
expires,  the  adjacency  with  the  neighbor  switch  is  broken  and 
new  paths  are  computed  to  all  possible  destination  switches  in 
the  fabric. 

Hello  timeout  value,  in  milliseconds.  When  this  timeout  expires, 
a  Hello  frame  is  sent  to  the  neighbor  switch  through  this  port. 

Retransmission  timeout  value,  in  milliseconds.  It  is  used  to 
transmit  topology  information  to  the  neighbor  switch.  If  no 
acknowledgement  is  received  within  this  value,  the  frame  is 
retransmitted. 

Total  number  of  commands  accepted  from  the  neighbor  switch. 
Number  includes  Helios,  Link  State  Updates  (LSU),  and  LSAs. 

Number  of  invalid  commands  received  from  the  neighbor  switch. 
Usually  commands  with  an  FSPF  version  number  higher  than  the 
one  running  on  the  local  switch. 

Number  of  Hello  frames  received  from  the  neighbor  switch. 

Number  of  invalid  Hello  frames  (Hello  frames  with  invalid 
parameters)  received  from  the  neighbor  switch. 

Number  of  LSUs  received  from  the  neighbor  switch. 

Number  of  LSAs  received  from  the  neighbor  switch. 

Number  of  attempted  transmissions  of  Hello  frames  to  the 
neighbor  switch. 

Number  of  Hello  frames  transmitted  to  the  neighbor  switch. 

Number  of  attempted  transmissions  of  LSUs  to  the  neighbor 
switch. 

Number  of  LSUs  transmitted  to  the  neighbor  switch. 

Number  of  attempted  transmissions  of  LSAs  to  the  neighbor 
switch. 

Number  of  LSAs  transmitted  to  the  neighbor  switch. 
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Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  list  valid  ports.  This  operand  is 
optional;  if  omitted,  the  interface  information  for  all  ports  is 
displayed. 

When  no  slot  number  and  port  number  are  specified,  this  command  displays  the  interface  information 
all  ports  on  the  switch  (including  non-E_Ports). 

Examples 

To  display  FSPF  interface  information: 

switch:user>  interf aceshow  1/4 
idbP  =  0xl008b3d0 

Interface  4  data  structure: 


nghbP 

0x1008 

c66S 

! 

if  No 

4 

masterPort 

4  (sel 

f ) 

def aultCost 

500 

cost 

500 

delay 

1 

lastScn 

16 

lastScnTime 

Apr 

02 

20: 

:01: 

:44. 

,458 

upCount 

2 

lastUpTime 

Apr 

02 

20: 

:01: 

:44. 

.458 

downCount 

1 

lastDownTime 

Apr 

02 

20: 

:01: 

:09. 

.  050 

downReason 

2 

iState 

UP 

Neighbor  4  data  structure: 
(continued  on  next  page) 
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n 
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U 

nLsuIn 
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3 

attLsaOut 

2 

nLsaOut 

2 

See  also 

nbrStateShow 

portShow 

switchShow 
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interopMode 


Enables  or  disables  HP  switch  interoperability  with  switches  from  other  manufacturers. 


Synopsis 

interopmode  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  interoperability  mode  for  individual  HP  switches.  This  feature 
enables  other  manufacturers'  switches  to  be  used  in  an  HP  fabric. 

This  command  must  be  executed  on  all  HP  switches  in  the  fabric.  Each  switch  must  be  rebooted  after 
changing  the  interoperability  mode  for  the  change  to  take  effect.  In  a  heterogeneous  fabric,  several  HP 
features  are  not  available  in  order  to  provide  maximum  compatibility  between  switches. 

HP  domain  IDs  must  be  between  97  and  1 27  for  successful  connection  to  other  switches.  The  firmware 
automatically  assigns  a  valid  domain  ID,  if  necessary,  when  interoperability  mode  is  enabled. 

Before  enabling  interoperability  mode,  inspect  the  individual  switches  and  the  zoning  database  for 
compatibility,  disable  any  features  not  supported  in  interoperability  mode,  and  disable  the  Platform 
Management  functions  using  the  msPlMgmtDeactivate  command. 

When  the  switch  is  running  in  interoperability  mode,  the  following  parameters  cannot  be  changed  using 
the  configure  command:  Port  number  zoning,  Node  WWN  zoning,  QuickLoop  zoning,  virtual  channel 
encoded  address,  and  Secure  Fabric  OS. 

When  interoperability  mode  is  disabled,  configuration  parameters  are  returned  to  their  default  states  and 
can  be  changed  using  the  configure  command. 


r2£b?  NOTE:    When  you  are  in  interoperability  mode,  the  only  type  of  zoning  supported  is  port  WWN  zoning. 


When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


This  command  has  the  following  operand: 


mode 


Specify  1  to  enable  interoperability  mode;  specify  0  to  disable 
interoperability  mode.  This  operand  is  optional;  if  omitted,  this 
command  displays  the  current  value. 
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Examples 

To  view  and  then  enable  interoperability  mode: 


switch : admin>  interopmode 
InteropMode :  Off 

Usage:  InteropMode  0 | 1 

0:   to  turn  it  off 
1 :   to  turn  it  on 

switch : admin>  interopmode  1 

done . 

Interopmode  is  enabled, 
switch: admin>  reboot 

See  also 

configure 
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iodReset 

Turns  off  the  in-order  delivery  (IOD)  option. 

Synopsis 

iodreset 

Availability 

admin 

Description 

Use  this  command  to  turn  off  the  IOD  option.  The  IOD  option  is  turned  off  by  default;  however,  if  the  IOD 
option  was  turned  on  using  iodSet,  this  command  can  be  used  to  turn  it  off  again.  Disabling  IOD  allows 
fast  re-routing  after  a  fabric  topology  change. 

This  command  might  cause  out-of-order  delivery  of  frames  during  fabric  topology  changes. 
Operands 

none 

Examples 

To  turn  off  the  IOD  option: 

switch : admin>  iodreset 
switch : admin>  iodshow 


IOD  is  not  set 


See  also 

iodSet 
iodShow 
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iodSet 

Enables  the  in-order  delivery  (IOD)  option. 

Synopsis 

iodset 

Availability 

admin 

Description 

Use  this  command  to  enforce  in-order  delivery  of  frames  during  a  fabric  topology  change. 

In  a  stable  fabric,  frames  are  always  delivered  in  order,  even  when  the  traffic  between  switches  is  shared 
among  multiple  paths.  However,  when  topology  changes  occur  in  the  fabric  (for  instance,  a  link  goes 
down),  traffic  is  rerouted  around  the  failure  and  some  frames  might  be  delivered  out  of  order.  This 
command  ensures  that  frames  are  not  delivered  out-of-order,  even  during  fabric  topology  changes. 

The  default  behavior  is  for  the  IOD  option  to  be  off. 

This  command  should  be  used  with  care,  because  it  can  cause  a  delay  in  the  establishment  of  a  new  path 
when  a  topology  change  occurs.  Only  if  there  are  devices  connected  to  the  fabric  that  do  not  tolerate 
occasional  out-of-order  delivery  of  frames,  should  this  command  be  used. 

Operands 

none 

Examples 

To  turn  on  the  IOD  option: 


switch 

admin> 

iodset 

switch 

admin> 

iodshow 

IOD  is 

set 

See  also 


iodReset 
iodShow 
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iodShow 

Displays  the  in-order  delivery  (IOD)  option  setting. 

Synopsis 

iodshow 

Availability 

all  users 

Description 

Use  this  command  to  display  whether  the  IOD  option  is  enabled  or  disabled. 

Operands 

none 

Examples 

To  display  the  current  setting  of  the  IOD  option: 

switch :admin>  iodshow 

IOD  is  not  set 

See  also 

iodReset 
iodSet 
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ipAddrSet 

Sets  the  IP  address  details  for  a  switch  or  control  processor  (CP). 

Synopsis 

ipaddrset   [-cp  number]    [-sw  number] 

Availability 

admin 


Description 

Use  this  command  to  set  the  IP  addresses  on  the  switch  or  CP.  If  no  option  is  provided  on  a  chassis-based 
system,  the  command  displays  the  usage.  To  set  the  CP  IP  address  use  -cp;  to  set  the  switch  IP  address  use 
-sw.  When  setting  the  switch,  the  command  prompts  for  the  Ethernet  IP  address,  Ethernet  subnetmask, 
Fibre  Channel  IP  address,  and  Fibre  Channel  subnetmask.  When  setting  the  CP,  the  command  prompts  for 
the  Ethernet  IP  address,  Ethernet  subnetmask,  host  name,  and  gateway  IP  address. 

Valid  switch  and  CP  values  depend  on  the  platform  from  which  the  command  is  being  run.  For  a 
nonchassis-based  switch,  the  command  ignores  all  operands.  The  command  prompts  for  the  Ethernet  IP 
address,  Ethernet  subnetmask,  Fibre  Channel  IP  address,  Fibre  Channel  subnetmask,  and  gateway  IP 
address. 

Operands 

This  command  has  the  following  operands  on  a  chassis-based  system: 
-cp  number  Valid  options  include: 

•  0  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  gateway 
IP  address,  and  host  name  of  CPO. 

•  1  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  gateway 
IP  address,  and  host  name  of  CP1 . 

-sw  number  Valid  options  include: 

•  0  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  Fibre 
Channel  IP  address,  and  Fibre  Channel  subnetmask  of 
logical  switch  0. 

•  1  sets  the  Ethernet  IP  address,  Ethernet  subnetmask,  Fibre 
Channel  IP  address,  and  Fibre  Channel  Subnetmask  of 
logical  switch  1 . 

If  no  option  is  specified  the  command  displays  the  usage. 

Examples 

To  set  the  IP  address  details  for  logical  switch  1  on  a  chassis-based  system: 


switch : admin>  ipaddrset  - 

sw  1 

Ethernet  IP  Address  [192. 

168.166 

148]  : 

Ethernet  Subnetmask  [255. 

255 .255 

0]  : 

Fibre  Channel  IP  Address 

[none] : 

Fibre  Channel  Subnetmask 

[none] : 

Committing  configuration. 

. . Done . 

OK. 
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See  also 

ipAddrShow 
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ipAddrShow 

Display  the  IP  address  information  for  a  switch  or  control  processor  (CP). 

Synopsis 

ipaddrshow   [-cp  cp_number]    |    [-sw  sw_number] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  IP  addresses  configured  in  the  system. 

The  -cp  option  displays  the  CP  IP  address  and  the  -sw  option  displays  the  switch  IP  addresses.  For 
switches,  the  command  displays  the  Ethernet  IP  address,  Ethernet  subnetmask,  Fibre  Channel  IP  address, 
and  Fibre  Channel  subnetmask.  For  CPs,  the  command  displays  the  Ethernet  IP  address,  Ethernet 
subnetmask,  host  name,  and  gateway  IP  address. 

Operands 

This  command  has  the  following  operands: 

-cp  cp_number  For  dual-CP  systems,  specify  CP  card  number  to  display  (0  or  1). 

-sw  sw_number  For  dual-domain  systems,  specify  the  switch  number  to  display  (0  or  1 ). 

If  no  operands  are  specified,  the  command  displays  all  the  IP  addresses  configured  in  the  system.  For 
nonchassis-based  switches,  this  command  ignores  all  operands. 

Examples 

To  display  the  IP  address  for  logical  switch  0: 

switch : admin>  ipaddrshow  -sw  0 
Ethernet  IP  Address:  192.168.166.147 
Ethernet  Subnetmask:  255.255.255.0 
Fibre  Channel  IP  Address :  0.0.0.0 
Fibre  Channel  Subnetmask:  0.0.0.0 

See  also 

ipAddrSet 
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islShow 

Displays  ISL  information. 

Synopsis 

islshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  connections  and  status  of  the  ISL  of  each  port  on  this  switch.  The 
WWN  to  which  the  ISL  is  connected,  the  speed  of  the  connection,  and  whether  this  ISL  is  trunked  are 
displayed. 

Operands 

none 

Examples 

To  display  the  ISL  connections  for  the  switch: 


switch 

:admin>  islshow 

1:  33 

->  29       10 : 00 : 00 : 60 

69  : 

80 

4f : 

84 

switch 

sp: 

2G 

bw: 

4G 

TRUNK 

2:  39 

->      7  10:00:00:60 

69  : 

80 

4f  : 

84 

switch 

sp: 

2G 

bw: 

8G 

TRUNK 

3  :  41 

->  (incompatible) 

4  :  47 

->  (incompatible) 

5:  57 

->  25       10 : 00 : 00 : 60 

69  : 

80 

4f : 

84 

switch 

sp: 

2G 

bw: 

4G 

TRUNK 

6:  60 

->     2  10:00:00:60 

69  : 

80 

4f : 

84 

switch 

sp: 

2G 

bw: 

4G 

TRUNK 

See  also 

switchShow 


Fabric  OS  5.x  command  reference  guide  317 


item  List 

Lists  parameter  syntax  information. 

Synopsis 

item_list =  element  \  element  white  item_list 

element  =  item  \    item  -  item 

item  =  num  \  slot  [  white  ]  /  [  whi  te  ]  num 

slot  =  num 

num  =  hex  \  int 

int  =  int  digit  \  digit 

hex =  Ox  hex  digit  \  hex  hex  digit 

digit  =  0|1|2|3|4|5|6|7|8|9 

hex  digit =  digit  |A|B|c|D|E|F|a|b|c|d|e|f 

white  =  * ["\t\f\r   , "] 

Description 

All  kernel  diagnostics  have  at  least  one  item  list  parameter  to  specify  which  ports  to  test.  The  normal 
default  value  for  this  parameter  is  to  select  everything. 

NOTE:    This  is  not  a  command;  rather,  it  is  a  common  parameter  to  many  commands. 

If  you  want  to  restrict  the  items  to  be  tested  to  a  smaller  set,  the  parameter  value  is  an  item  list  with  the 
following  characteristics: 

•  It  is  a  comma-separated  list  of  items. 

•  Each  item  in  the  list  might  be  a  single  element  or  a  range  of  elements  indicated  by  a  hyphen  (■)  and  be 
mixed  with  individual  values. 

•  Spaces  and  tab  stops  are  skipped. 

•  Each  item  might  be  preceded  by  an  optional  slot  number  and  foward  slash  (/). 

For  example,  0,3,4-6,1;   0  , 1 ,  3  ,  4 ,  5 ,  6 ;  and  0  3  4-6  1  each  select  items  0  ,   1,   3,   4,  5, 

6 

Besides  the  syntax  rules,  there  are  also  some  grammatical  restrictions  on  the  slot  numbers: 

•  Once  specified,  a  slot  selection  applies  to  all  items  to  the  right  of  the  slot  selections  until  the  next  slot 
selection  or  the  end  of  the  item  list.  For  example,  1/0  -  15  and  1/0  -  1/15  are  equivalent. 

•  If  no  slot  number  is  specified,  user  port  lists  are  specified  by  area  number.  For  instance,  0 ,  16 ,  32 
and  1/0,  2/0,  3/0  specify  the  same  ports  on  a  1 6-port/blade  system.  On  that  same  system,  1  /  0 , 
16 ,  32  is  not  a  valid  list:  even  though  it's  syntax  is  legal,  the  ports  do  not  exist. 

•  If  no  slot  number  is  specified,  all  lists  except  user  port  lists  will  use  the  default  slot  0. 

•  No  list  type  except  for  user  port  lists  might  specify  multiple  conflicting  slot  numbers.  For  instance,  1  /  0 , 
2  /  0 ,   3  /  0  is  a  valid  user  port  list  but  is  not  valid  for  any  other  type  of  list. 
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In  the  case  of  conflicting  settings  within  a  single  item  list,  an  error  is  generated,  as  described  earlier.  In 
the  case  of  multiple  item  list  parameters,  the  last  one  on  the  command  line  overrides  previous  settings. 


The  exact  type  of  list  varies,  depending  on  the  test  and  the  parameter;  however,  the  most  common  are 
blade  ports  and  user  ports.  A  list  of  blade  ports  is  most  commonly  used  by  ASIC-level  tests  such  as 
cmiTest  or  turboRamTest  and  represents  which  ports  on  the  current  blade  (specified  with  -slot  # 
parameter)  are  tested.  A  list  of  user  ports  is  used  by  the  higher-level  tests,  such  as  spinSilk  or 
cross PortTest,  to  specify  which  user-accessible  external  ports  within  the  current  switch  (selected  during 
telnet  login)  are  tested.  When  specified  in  an  item  list,  user  ports  might  be  specified  by  either  the  area 
portion  of  the  ports  Fibre  Channel  address  or  with  slot/ port  notation.  For  nonblade  systems,  the  port 
number  on  the  silkscreen  is  the  area  number,  so  the  two  notations  are  identical. 

The  exact  type  of  list  required  for  any  input  parameter  might  be  determined  with  the  diagCommandShow 
command.  For  item  list  parameters,  the  parameter  type  is  PT  LIST  and  the  list  type  is  one  of  those  shown  in 

Table  15. 


Table  15    Object  descriptions 


Type 

Grouping 

Description 

BPORTS 

Blade 

Blade  ports,  internal  and  external 
ports 

U  PORTS 

Switch 

User  ports,  ports  with  external 
connections 

QUADS 

Blade 

Quadrants,  group  of  (normally 
four)  ports 

CHIPS 

Blade 

Chips,  ASICs  within  a  blade 

MINIS 

Blade 

Mini-switches 

SLOTS 

Chassis 

Slots 

INDEX 

n.a. 

Anything 

Operands 

none 

Examples 

none 

See  also 

backport 
camTest 

centralMemoryTest 

cmeraRetentionTest 

cmiTest 

cross PortTest 

diagCommandShow 

portLoopbackTest 

portRegTest 
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killTelnet 

Terminates  an  open  telnet  session. 

Synopsis 

killtelnet 

Availability 

admin 

Description 

Use  this  command  to  terminate  an  open  telnet  session.  The  killTelnet  command  is  an  interactive 
menu-driven  command.  Upon  invocation,  it  lists  all  the  current  telnet  and  serial  port  login  sessions.  It  lists 
information  such  as  the  session  number,  login  name,  idle  time,  IP  address  of  the  connection,  and 
timestamp  of  when  the  login  session  was  opened.  A  prompt  is  then  displayed,  at  which  point  you  can 
specify  the  session  number  of  the  connection  you  want  to  terminate. 


NOTE:  The  list  of  open  sessions  displayed  with  killTelnet  includes  the  user's  current  session.  Make 
sure  you  do  not  kill  your  own  telnet  session. 


Operands 

none 

Examples 

To  terminate  an  open  telnet  connection: 
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switch : admin>  killtelnet 

Collecting  login  inf ormation . . . . Done 

List  of  telnet  sessions   (3  found) 


Session  NO  USER  TTY  IDLE  FROM  LOGINS 


rootO 

adminO 

adminO 


ttySO 
pts/0 
pts/1 


1 :  17m 

16.00s 

3.00s 


192 . 168 . 130 .29 
192 . 168 . 130 .29 


5 : 13pm 
6 : 2  9pm 
6 : 3 1pm 


Enter  Session  Number  to  terminate   (q  to  quit)  1 
Collecting  process  information...  Done. 

You  have  opted  to  terminate  the  telnet  session: - 

logged  in  as   "adminO   ",    from  "192.168.130.29  " 
since  "   6:29pm"  and  has  been  inactive  for  "16.00s 
the  current  command  executed  being:    "-rbash  ". 
The  device  entry  is:    "pts/0  ". 
This  action  will  effectively  kill  these  process (es) : - 


/dev/pts/0 


USER 

PID 

ACCESS 

COMMAND 

root 

12868 

f  

login 

root 

12869 

f  

login 

root 

12877 

f  

rbash 

(continued  on  next  page) 


Please  Ensure   (Y/ [N] ) :  y 
killing  session. . . .  Done! 
Collecting  login  inf ormation ....  Done 

List  of  telnet  sessions    (2  found) 


Session  NO  USER  TTY  IDLE  FROM  LOGINS 


0  rootO  ttySO  1:17m  -  5:13pm 

1  adminO  pts/1  3.00s  192.168.13  0.29  6:31pm 


Enter  Session  Number  to  terminate   (q  to  quit)  q 

See  also 

none 
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licenseAdd 

Adds  license  keys  to  switch. 

Synopsis 

licenseadd  "license 

Availability 

admin 


Description 

Use  this  command  to  add  license  keys  to  the  system. 

Some  features  of  the  switch  and  the  fabric  to  which  it  is  connected  are  optional,  licensed  products. 
Without  a  license  installed  for  such  products,  their  services  are  not  available. 

After  you  enter  a  license,  the  licensed  product  is  available  immediately  and  the  system  does  not  need  to 
be  rebooted.  An  exception  to  this  general  handling  is  that  the  switch  must  be  rebooted  if  a  fabric  license  is 
added  to  a  switch  that  lacks  a  fabric  license.  In  this  case,  the  switch  must  be  rebooted  to  allow  the 
software  to  recognize  the  license  and  initialize  itself  correctly. 

Also,  there  is  special  handling  required  when  a  trunking  license  is  added  to  the  switch.  For  a  trunking 
license  to  become  effective,  the  trunk  ports  need  to  be  refreshed  using  the  commands  portDisable  and 

portEnable,  or  the  switch  must  be  refreshed  using  the  commands  switchDisable  and 
switchEnable. 

Operands 

This  command  has  the  following  operand: 

license  Specify  a  license  key,  in  quotation  marks.  This  operand  is 

required. 

Examples 

To  add  a  license  key  to  the  switch: 

switch : admin>  licenseadd  MaBcDeFGhl2345 " 
adding  license  key  "  aBcDeFGh.12345  " 


See  also 

licenseRemove 
licenseShow 
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licenseHelp 

Displays  commands  used  to  administer  license  keys. 

Synopsis 

licensehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  the  commands  used  to  administer  license  keys. 

Operands 

none 

Examples 

To  display  license  commands: 


See  also 


switch :admin> 

licensehelp 

licenseAdd 
licenseldShow 
licenseRemove 
licenseShow 

Add  a  license  to  this  switch 
Show  system  license  ID 
Remove  a  license  from  this  switch 
Show  current  licenses 

licenseAdd 

licenseldShow 

lie  ens  eRemove 

licenseShow 
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licenseldShow 


Displays  system  license  ID. 


Synopsis 

licenseidshow 


Availability 

all  users 

Description 

Use  this  command  to  display  the  license  ID  of  the  system. 

Some  features  of  the  switch  and  the  fabric  are  optional,  licensed  products.  Without  a  license  installed  for 
such  products,  the  services  provided  by  these  features  are  not  available. 

For  dual-domain  systems,  a  single  license  enables  both  logical  switches  to  use  these  products.  The  chassis 
is  assigned  a  license  ID  from  which  a  license  is  generated.  Such  licenses  are  locked  and  are  only 
functional  on  the  specific  system  for  which  they  were  issued. 

This  command  displays  to  standard  output  the  system  license  ID  used  for  both  generating  and  validating 
licenses  on  the  system.  The  license  ID  format  is  eight  pairs  of  hexadecimal  values,  separated  by  colons. 
Each  hexadecimal  value  is  between  00  (0)  and  FF  (255). 


f-^f  NOTE:   While  the  format  of  this  identifier  might  be  similar  or  even  identical  to  other  identifiers  in  the 

system,  no  inferences  should  be  made  about  the  relationships  between  them  as  they  are  subject  to  change 
independently  of  one  another. 


Operands 

none 

Examples 

To  display  the  license  ID: 

switch : admin>  licenseidshow 
a4:f8:69:33:22:00:ea:18 

See  also 

license Add 
licenseHelp 
licenseRemove 
licenseShow 
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licenseRemove 


Removes  the  license  key  from  the  system. 

Synopsis 

licenseremove  "license1 

Availability 

admin 

Description 

Use  this  command  to  remove  an  existing  license  key  from  a  switch.  The  existing  license  key  must  be 
entered  exactly  as  shown  by  licenseShow,  including  case. 

When  the  key  has  been  entered,  use  the  licenseShow  command  to  verify  that  the  key  has  been 
removed  and  the  licensed  product  uninstalled. 

After  removing  a  license  key,  the  switch  must  be  rebooted.  With  no  license  key,  licenseShow  displays 

No  licenses. 

Operands 

The  following  operand  is  required: 

license  Specify  the  license  key,  in  quotation  marks.  This  operand  is 

required. 

Examples 

To  remove  a  license  key  from  the  switch: 

switch : admin>  licenseremove  "bQebzbRdScRf cOiK" 
removing  license  key  "bQebzbRdScRf cOiK" 

See  also 

licenseAdd 
licenseHelp 
licenseldShow 
licenseShow 
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licenseShow 

Displays  current  license  keys. 

Synopsis 

licenseshow 

Availability 

all  users 

Description 

Use  this  command  to  display  current  license  keys,  along  with  a  list  of  licensed  products  enabled  by  these 
keys.  The  message  No  license  installed  on  this  switch  is  displayed  when  no  licenses 
are  installed. 

Operands 

none 

Examples 

To  display  the  installed  license  keys  on  a  switch: 

switch : admin>  licenseshow 
bQebzbRdScRf cOiK: 

Web  license 

Zoning  license 
SybbzQQ9edTzccOX: 

Fabric  license 

See  also 

licenseAdd 
licenseHelp 
licenseldShow 
licenseRemove 
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linkCost 


Sets  or  displays  the  fabric  shortest  path  first  (FSPF)  cost  of  a  link. 

Synopsis 

linkcost    [slotnumber/]  [portnumber]  [,  cost] 

Availability 

admin 

Description 

Use  this  command  to  set  or  display  the  cost  of  an  inter-switch  link  (ISL).  The  cost  of  a  link  is  a  dimensionless 
positive  number.  The  FSPF  protocol  compares  the  cost  of  various  paths  between  a  source  switch  and  a 
destination  switch  by  adding  the  costs  of  all  the  ISL's  along  each  path.  FSPF  chooses  the  path  with 
minimum  cost.  If  multiple  paths  exist  with  the  same  minimum  cost,  FSPF  employs  load  sharing  over  these 
paths. 

Every  ISL  has  a  default  cost  that  is  inversely  proportional  to  its  bandwidth.  For  a  1-Gb/s  ISL,  the  default 
cost  is  1 000.  For  a  2-Gb/s  ISL,  the  default  cost  is  500. 

This  command  can  be  used  to  set  a  non-default,  static  cost  for  any  port. 

When  executed  without  arguments,  this  command  displays  the  current  cost  of  each  port  on  the  switch, 
even  those  are  not  ISL's.  Active  ISLs  have  an  additional  suffix  of  E  PORT  attached  to  their  interface 
number.  If  the  port  has  a  static  cost  assigned  to  it,  then  the  suffix  of  STATIC  is  appended  to  the  link  cost.  In 
this  case,  only  the  current  link  cost  is  displayed. 

Use  interf  aceShow  to  display  both  the  default  and  current  link  costs. 

To  remove  a  static  cost  from  the  database,  execute  this  command  with  a  cost  of  zero  on  the  desired  port. 
This  port  will  then  revert  to  its  default  link  cost. 


\^}f  NOTE:  Valid  cost  values  are  0  to  32767.  Assigning  a  value  outside  this  range  saves  and  displays  an 
t— I    abnormal  linkcost. 


Operands 

This  command  has  the  following  optional  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  list  valid  ports.  This  operand  is 
optional;  if  omitted,  the  cost  of  all  ports  is  displayed. 

cost  Specify  the  new  cost  of  the  link  connected  to  the  specified  port 

number. 

If  no  operands  are  specified,  the  current  values  for  all  ports  on  the  (logical)  switch  are  displayed. 
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Examples 

To  display  the  cost  of  a  link  and  set  that  cost: 


switch; 

: admin>  linkcost 

Slot 

Interface 

Cost 

2 

0 

500 

(STATIC) 

2 

1 

1000 

2 

2 

500 

(STATIC) 

2 

3 

200 

(STATIC) 

2 

4 

1000 

2 

5 

1000 

2 

6 

1000 

2 

7 

1000 

2 

8 

1000 

2 

9 

1000 

2 

10 

1000 

2 

11  (E_PORT) 

2000 

(STATIC) 

2 

12 

1000 

2 

13 

1000 

2 

14 

1000 

2 

15 

1000 

switch; 

: admin>  linkcost 

2/4  500 

switch; 

; admin>  linkcost 

2/4 

Slot 

2                Interface  4 

Cost 

500  (STATIC) 

switch; 

: admin>  linkcost 

2/4  0 

Slot 

2                Interface  4 

Cost 

1000 

See  also 

interf aceShow 
lSDbShow 
topologyShow 
uRouteShow 
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login 

Logs  in  as  a  new  user. 

Synopsis 

login 

Availability 

all  users 

Description 

Use  this  command  to  log  in  to  the  switch  with  another  user  name  and  password,  without  first  logging  out 
from  the  original  session.  If  the  user  was  originally  connected  using  a  telnet  or  rlogin  session,  that  session 
is  left  open. 

This  command  allows  you  to  access  commands  that  you  cannot  access  at  your  current  user  level. 
Operands 

none 

Examples 

To  log  in  as  admin  from  the  login  user: 

switch:user>  login 
login:  admin 
Password : xxxxxx 

See  also 

logout 
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logout 

Logs  out  from  a  telnet,  rlogin,  or  serial  port  session. 

Synopsis 

logout 

Availability 

all  users 

Description 

Use  this  command  to  log  out  from  a  telnet,  rlogin,  or  serial  port  session.  Telnet  and  rlogin  connections  are 
closed  and  the  serial  port  returns  to  the  login:  prompt. 

The  exit  command  is  accepted  as  a  synonym  for  logout,  as  is  Ctrl-D  at  the  beginning  of  a  line. 

NOTE:    If  you  close  a  telnet  or  sectelnet  session  by  clicking  the  "X"  in  the  upper-right  corner,  the  window 
closes  but  the  session  stays  open  until  it  times  out.  Trying  to  open  another  session  before  the  timeout  has 
completed  causes  an  error  message  to  display. 


Operands 

none 

Examples 

To  log  out  from  an  rlogin  session: 

switch : admin>  logout 
Connection  to  host  lost. 

See  also 

login 
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loopPortTest 

Functional  test  of  L_Port  M->M  path  on  a  loop. 

Synopsis 


loopporttest  [-nframes  count] [-ports  itemlist]  [-seed 
payload_pattern]  [-width  pattern_width] 


Availability 

admin 


Description 

Use  this  command  to  verify  the  operation  of  the  switch  by  sending  frames  from  port  M's  transmitter  and 
looping  the  frames  back  through  an  external  fiber  cable,  including  all  the  devices  on  the  loop,  into  port 
M's  receiver.  This  exercises  all  the  switch  components,  from  the  main  board,  to  the  SFP,  to  the  fiber  cable, 
to  the  SFPs  (of  the  devices  and  the  switch),  and  back  to  the  main  board. 

The  cables  and  SFPs  connected  should  be  of  the  same  technology,  meaning  that  a  short  wavelength  SFPed 
(switch)  port  is  connected  to  another  short  wavelength  SFPed  (device)  port  through  a  short  wavelength 
cable;  and  a  long  wavelength  port  is  connected  to  a  long  wavelength  port;  and  a  copper  port  is 
connected  to  a  copper  port. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  The  port  LEDs  flicker  green  rapidly  while  the 
test  is  running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  L  Ports. 

2.  Enable  ports  for  cabled  loopback  mode. 

3.  Create  a  frame  F  of  data  size  (1 024  bytes). 

4.  Transmit  frame  F  through  port  M,  with  D_ID  to  the  FL_Port  (AL_PA  =  0). 

5.  Pick  up  the  frame  from  port  M,  the  FL  Port. 

6.  Check  if  any  of  the  eight  statistic  error  counters  are  nonzero:  ENC_in,  CRC_err,  TruncFrm,  FrmTooLong, 
BadEOF,  Enc_out,  BadOrdSet,  DiscC3. 

7.  Check  if  the  transmit,  receive,  or  class  3  receiver  counters  are  stuck  at  some  value. 

8.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

9.  Repeat  step  3  through  step  8  for  all  ports  present  until  either  the  number  of  frames  requested  is 
reached  or  all  ports  are  marked  bad. 

You  can  specify  a  payload  pattern  to  be  used  when  executing  this  test.  If  the  pattern  is  not  specified,  then 
at  every  30  passes,  a  different  data  type  is  used  to  generate  a  new  pattern  to  create  the  frame.  The  data 
pattern  is  generated  based  on  each  data  type.  Some  data  types  might  generate  different  data  patterns  on 
every  pass.  The  data  types  are  repeated  every  210  pass. 

Operands 

This  command  has  the  following  operands: 

-nframes  count  Specify  the  number  of  times  (or  number  of  frames  per  port)  to 

execute  this  test.  The  default  value  is  1 0. 

-ports  itemlist  Specify  a  list  of  user  ports  to  test.  By  default,  all  user  ports  in  the 

current  slot  are  tested.  See  itemList  for  more  information  on 
selecting  ports. 
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-seed  payload _pattern        Specify  the  seed  pattern  of  the  test  packets.  The  data  types  are: 


1 

CSPAT 

0x7e,  0x7e,  0x7e,  0x7e, 

2 

BYTE_LFSR 

0x69,  0x01,  0x02,  0x05, 

3 

CHALFSQ 

0x4a,  0x4a,  0x4a,  0x4a, 

4 

QUADNOT 

0x00,  Oxff,  0x00,  Oxff,  ... 

5 

CQTR_SQ 

0x78,  0x78,  0x78,  0x78, 

6 

CRPAT 

Oxbc,  Oxbc,  0x23,  0x47,  . 

7 

RANDOM 

0x25,  0x7f,  0x6e,  0x9a, 

-width  pattern_width  Specify  the  width  of  the  test  pattern.  Valid  values  include: 

1  for  byte  (default) 

2  for  word 

3  for  quad 

This  operand  is  optional. 

Examples 

To  perform  a  loopback  port  test: 

switch : admin>  loopporttest  -ports  1/0-1/15 

Running  Loop  Port  Test   

Test  Complete:    "loopporttest"  Pass  10  of  10 
Duration  0  hr,    0  min  &  1  sec  (0:0:0:127). 
passed. 

See  also 

camTest 

centralMeraoryTest 

cmemRetentionTest 

cmiTest 

cross PortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sraraRetentionTest 
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ISDbShow 

Displays  the  Fabric  Shortest  Path  First  (FSPF)  link  state  database. 

Synopsis 

lsdbshow  [domain] 

Availability 

all  users 

Description 

Use  this  command  to  display  an  FSPF  link  state  database  record  for  switches  in  the  fabric,  or  one  domain 
within  it. 

There  are  two  types  of  database  entries: 

The  link  state  database  entry,  which  is  permanently  allocated. 

•   The  link  state  record  (LSR),  which  is  allocated  when  a  switch  is  connected  to  the  fabric. 

The  LSR  describes  the  links  between  connected  domains  in  a  fabric.  For  a  link  to  be  reported  in  the  LSR, 
the  neighbor  for  that  link  must  be  in  NB  ST  FULL  state. 

This  command  displays  the  content  of  both  types  of  database  entries,  if  both  are  present. 
The  fields  described  in  Table  1  6  appear. 
Table  16    IsdbShow  display  fields 


Field 

Description 

Domain 

Domain  number  described  by  this  LSR.  A  (self)  keyword  after  the 
domain  number  indicates  that  LSR  describes  the  local  switch. 

IsrP 

Pointer  to  LSR. 

earlyAccLSRs 

Number  of  LSRs  accepted,  even  though  they  were  not  sufficiently 
spaced  apart. 

ignoredLSRs 

Number  of  LSRs  not  accepted  because  they  were  not  sufficiently 
spaced  apart. 

lastlgnored 

Last  time  an  LSR  was  ignored. 

installTime 

Time  this  LSR  was  installed  in  the  database,  in  seconds  since  boot. 

IseFlags 

Internal  variable. 

uOutlfs 

Internal  variable 

uPathCost 

Internal  variable. 

uOldHopCount 

Internal  variable. 

uHopsFromRoot 

Internal  variable. 

mOutlfs 

Internal  variable. 
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Table  16    IsdbShow  display  fields  (continued) 


Field 

Description 

parent 

Internal  variable. 

mPathCost 

Internal  variable. 

m  Hops  From  Root 

1    i          1  -LI 

Internal  variable. 

1  A 

Is  Age 

a          ■                   I         f  j.1  ■     i  r*  n     a      i  r*  n  ■                     IT          il        i    ■  i 

Age,  in  seconds,  ot  this  LbK.  An  LbK  is  removed  trom  the  database 
when  its  age  exceeds  3,600  seconds. 

reserved 

Reserved  for  future  use. 

type 

Type  of  the  LSR.  Always  1 . 

options 

Always  0. 

Isld 

ID  of  this  LSR.  It  is  identical  to  the  domain  number. 

advertiser 

ID  (domain  number)  of  the  switch  that  originated  this  LSR. 

incarn 

i                l'                 1           r  i 1  •     i  f  n 

Incarnation  number  ot  this  LbK. 

1  il 

length 

-rill        ±1    /•     1     i     \     f  ±1  •    i  rn    ill       1         1             1  1*   1     l  l 

lotal  length  (in  bytes)  ot  this  LbK.  Includes  header  and  link  state 
information  for  all  links. 

L  1 

chksum 

f\-       1                  £  1    1    1  1  CD         'iL                  !•             I  1    A          I"    1  1 

Checksum  ot  total  LbK,  with  exception  ot  IsAge  tield. 

ImkCnt 

kl        L         £  I-    1           iL-     1  CD    c      L  I-    1                     i              •  LL 

Number  ot  links  in  this  LSK.  bach  link  represents  a  neighbor  in 
NB_ST_FULL  state. 

tlags 

Always  0. 

i  •  mi 
Lmkld 

i  r\     (  il  1    l<   1    ii  ■    J        1          •             1          f  ±1           -l  1          ±1        ±1         •  1 

ID  ot  this  link.  It  is  the  domain  number  ot  the  switch  on  the  other  side 
of  the  link. 

out  port 

Port  number  on  the  local  switch. 

rem  port 

Port  number  of  the  port  on  the  other  side  of  the  link. 

cost 

Cost  of  this  link.  The  default  cost  for  a  1  Gb/sec  link  is  1 000. 

costCnt 

Always  0. 

type 

Always  1 . 

Operands 

This  command  has  the  following  operand: 

domain  Specify  the  domain  number  of  the  LSR  to  be  displayed.  This 

operand  is  optional;  if  omitted,  the  entire  link  state  database  is 
displayed. 
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Examples 

To  display  the  link  state  record  for  a  switch: 


switch : admin>  lsdbshow  1 


Link  State  Record: 


Link  State 

Record 

pointer 

=  0xl0053dlJ 

IsAge 

16 

reserved 

0 

type 

1 

options 

0x0 

lsld 

1 

advertiser 

1 

incarn 

0x80000014 

length 

284 

chksum 

0x8453 

linkCnt  = 

16, 

flags 

=  0x0 

Linkld  = 

2  , 

out 

port 

16, 

rem 

port 

Linkld  = 

2  , 

out 

port 

17, 

rem 

port 

Linkld  = 

2  , 

out 

port 

18, 

rem 

port 

Linkld  = 

2  , 

out 

port 

19, 

rem 

port 

Linkld  = 

2  , 

out 

port 

24, 

rem 

port 

Linkld  = 

2  , 

out 

port 

25, 

rem 

port 

Linkld  = 

2  , 

out 

port 

26, 

rem 

port 

Linkld  = 

2  , 

out 

port 

27, 

rem 

port 

Linkld  = 

2, 

out 

port 

32, 

rem 

port 

Linkld  = 

2, 

out 

port 

33, 

rem 

port 

48, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

49, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

50, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

51, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

56, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

57, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

58, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

59, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

0, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

X, 

cost  = 

500, 

costCnt  = 

0, 

type  = 

1 

(continued  on  next  page) 
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T  -i  nVTH  — 
J_i  J_I1js.±U.  — 

9 

z  , 

out  port  — 

7  A 

rem 

port  — 

9 

z  , 

cost 

-  r  n  n 

1  /-N  O  1—  4—   

LUb  L-^Il  L-  — 

A 
U  , 

type  = 

1 

J_i.LIlJS.XU.  — 

2 

UUL     kJU-L  l_  — 

O  _>  / 

port  — 

■J  / 

cost 

-  Rfi n 

—  jUU  / 

L-Ub  — 

n 

U  / 

type  = 

]_ 

_j_.I1jS.±(J.  — 

9 

z  , 

rtl  1  f-        v-^        V™  "H   

UUL-    pul  L.  — 

A  A 

rem 

port  — 

J_  z  , 

cost 

-  r  n  n 

n 

U  / 

type  = 

j. 

Linkld  = 

2  , 

out  port  = 

45, 

rem 

port  = 

13, 

cost 

=  500, 

costCnt  = 

o, 

type  = 

1 

Linkld  = 

2  , 

out  port  = 

46, 

rem 

port  = 

14, 

cost 

=  500, 

costCnt  = 

0, 

type  = 

1 

T  -i  nVTH  — 
_j_.I1Js.±U.  — 

2  , 

out  port  = 

47, 

rem 

port  = 

15, 

cost 

=  500, 

costCnt  = 

0, 

type  = 

1 

The  local 

switch  has  sixteen 

links  in  NB_ 

_ST_FULL  state,  all  of  them 

are 

connected 

to 

switch  2 . 

See  also 

interf aceShow 
nbrStateShow 


336   Fabric  OS  commands 


memShow 

Displays  the  amounts  of  free  and  used  memory  in  a  switch. 

Synopsis 

memshow   [   -b   |    -k   |    -m  ] 

Availability 

all  users 

Description 

Use  this  command  to  display  free  and  used  memory  in  the  switch,  as  well  as  the  shared  memory  and 
buffers  used  by  the  kernel. 

Operands 

This  command  has  the  following  operands: 

-b  Specify  to  display  memory  usage  in  bytes, 

-k  Specify  to  display  memory  usage  in  kilobytes, 

-m  Specify  to  display  memory  usage  in  megabytes. 

By  default,  memory  usage  is  displayed  in  bytes. 

Examples 

To  view  the  memory  usage: 


switch 

admin>  memshow 

total 

used 

free 

shared 

buffers 

cached 

Mem: 

129740800  112562176 

17178624 

0 

139264 

30396416 

Swap : 

0 

0 

0 

switch 

admin>  memshow 

-m 

total 

used 

free 

shared 

buffers 

cached 

Mem: 

123 

107 

16 

0 

0 

28 

Swap : 

0 

0 

0 

See  also 

saveCore 
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miniCycle 


Runs  a  functional  test  of  internal  and  external  transmit  and  receive  paths  at  full  speed. 


Synopsis 

minicycle  [--slot  slotnumber]  [-nmegs  count] [-lb_mode  mode]  [ -spd_mode 
mode]  [-ports  itemlist] 


Use  this  command  to  verify  the  intended  functional  operation  of  an  ASIC  pair  (miniswitch)  at  the 
maximum  or  selected  speed  by  setting  up  the  routing  hardware  so  that  frames  received  by  port  M  are 
retransmitted  by  way  of  port  N.  Likewise,  frames  received  by  port  N  are  retransmitted  by  way  of  port  M. 
Each  port  M  sends  two  frames  to  its  partner,  port  N. 

This  test  is  run  as  a  series  of  eight  path  tests.  Each  port  on  the  ASIC  pair  is  exchanging  frames  with  one 
port  on  the  adjacent  ASIC  in  the  same  miniswitch.  At  the  end  of  a  path  test,  the  frames  are  captured  and 
the  routing  is  changed  so  that  each  port  exchanges  frames  with  the  next  port  on  the  adjacent  ASIC  of  the 
same  miniswitch. 

Unlike  implementation  of  the  spinSilk  command,  a  port  is  only  exchanging  frames  with  one  other  port 
at  a  time  under  the  miniCycle  command.  Just  like  with  spinSilk,  all  ports  are  active  and  exchanging 
frames  simultaneously  with  miniCycle. 

The  path  number  being  tested  determines  the  partner  port  N  for  each  port  M  (bold  and  italicized  in  the 
following  example): 


path 

0  : 

0-8, 

1 

-9, 

2 

-10, 

3 

-11, 

4 

-12  , 

5 

-13, 

6 

-14, 

7 

-15 

path 

1: 

7-8, 

0 

-9, 

1 

-10, 

2 

-11, 

3 

-12  , 

4 

-13, 

5 

-14, 

6 

-15 

path 

2  : 

6-8, 

7 

-9, 

0 

-10, 

1 

-11, 

2 

-12  , 

3 

-13, 

4 

-14, 

5 

-15 

path 

3  : 

5-8, 

6 

-9, 

7 

-10, 

0 

-11, 

1 

-12  , 

2 

-13, 

3 

-14, 

4 

-15 

path 

4: 

4-8, 

5 

-9, 

6 

-10, 

1 

-11, 

0 

-12, 

1 

-13, 

2 

-14, 

3 

-15 

path 

5: 

3-8, 

4 

-9, 

5 

-10, 

6 

-11, 

7 

-12  , 

0 

-13, 

1 

-14, 

2 

-15 

path 

6: 

2-8, 

3 

-9, 

4 

-10, 

5 

-11, 

6 

-12  , 

7 

-13, 

0 

-14, 

1 

-15 

path 

7  : 

1-8, 

2 

-9, 

3 

-10, 

4 

-11, 

5 

-12  , 

6 

-13, 

7 

-14, 

0 

-15 

\^)f  NOTE:   The  port  numbers  are  relative  to  the  ASIC  pair.  This  test  does  not  route  frames  from  one 


Ports  cabled  to  other  ports  fail  if  port  loopback  mode  is  selected,  and  the  port  must  have  media  and 
loopback  plugs  installed.  For  best  coverage,  you  should  use  self-loopback  plugs  and  port  loopback  mode 
(-lb_mode  l),  as  each  port's  external  connectivity  will  be  tested. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  runs. 

The  path  test  method  is  as  follows: 

1 .  Clear  port  statistics  and  error  counters. 

2.  Enable  ports  for  specified  self-loopback  mode. 


Availability 


admin 


Description 


338   Fabric  OS  commands 


3.  Configure  up  the  routing  table  so  that  when  port  M  receives  frames,  the  frames  are  routed  back  to  the 
partner  port  N  and  vice  versa. 

4.  Transmit  two  frames  by  way  of  port  M  and  two  frames  by  way  of  port  N.  The  following  four  patterns 
will  be  used  for  the  four  frames,  one  pattern  each: 

•  1000  bytes  of  CSPAT 

•  480  bytes  of  RDRAM_PAT 

•  2112  bytes  of  BYTEJ.FSR 

•  200  bytes  of  RANDOM 

5.  Periodically  check  status: 

a.  Each  port  has  not  died. 

b.  Each  port's  frames-transmitted  counter  is  still  incrementing. 

c.  Each  port's  statistic  error  counters  are  nonzero: 

d.  ENC_in,  CRC_err,  TruncFrm,  FrmTooLong,  BadEOF,  Enc_out,  BadOrdSet,  DiscC3 

e.  Until  one  of  the  following  is  met: 

•  The  number  of  frames  requested  is  met  on  all  selected  ports. 

•  All  ports  are  eventually  marked  bad. 

•  The  user  aborts  the  procedure. 

The  path  test  is  repeated  for  each  path,  unless  it  is  aborted  by  a  keyboard  interrupt.  The  data  is  not  read 
and  checked  as  was  done  in  portLoopbackTest  and  crossPortTest.  There  is  no  CPU  intervention 
during  a  path  test  besides  the  periodic  checks  of  the  hardware  counters.  At  the  end  of  a  path  test,  all 
statistics  and  routes  are  reset  for  the  next  path  test. 

An  example  of  the  data  used  is  as  follows: 

CSPAT:  0x7e,  0x7e,  0x7e,  0x7e,  ... 

RDRAM_PAT:  Oxff,  0x00,  Oxff,  0x00,  ... 

BYTE_LFSR:  0x69,  0x01,  0x02,  0x05,  ... 

RANDOM:  0x25,  0x7 f,  0x6e,  0x9a,  ... 

Because  this  test  includes  the  media  and  the  fiber  cable  loopback  plug  in  its  test  path,  its  results  combined 
with  the  results  of  portLoopbackTest  and  spinSilk  can  be  used  to  determine  which  components  of  the 
switch  are  faulty. 


Operands 


The  following  operands  are  optional: 


-lb_mode  mode 


--slot  slotnumber 


-nmegs  count 


Specifies  the  slot  number  on  which  the  diagnostic  operate.  The  ports 
specified  are  relative  to  this  slot  number.  The  default  is  set  to  0  and 
designed  to  operate  on  fixed-port-count  products. 

Specifies  the  number  of  million  frames  to  send  per  path  test.  The  path 
test  will  progress  until  the  specified  number  of  frames  has  been 
transmitted  on  each  port.  The  default  value  for  count  is  1 ,  so  the  total 
number  of  frames  sent  will  be  at  least  8  million  (1  million  frames  *  8 
paths). 

Selects  the  loopback  point  for  the  test.  By  default,  miniCycle  uses 
external  (SERDES)  loopback. 

1  Port  Loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
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5  Internal  (parallel)  loopback 

7  Backend  bypass  and  port  loopback 

8  Backend  bypass  and  SERDES  loopback 

9  Backend  bypass  and  internal  loopback 


-spd_mode  mode        Specifies  the  speed  mode  for  the  test.  This  parameter  is  only  used  for 

Bloom  and  Condor  ASIC-based  products,  for  which  this  parameter 
controls  the  speed  at  which  each  port  operates.  For  lG-only  products, 
this  parameter  is  ignored.  The  exact  operation  of  modes  5  through  8 
depends  on  the  loopback  mode  selected.  When  speed  modes  5 
through  8  are  used  with  cables,  they  must  be  connected  EVEN->ODD 
or  the  test  fails. 

0  Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s  (default). 

1  Set  all  port  speeds  to  lock  at  1  Gb/s. 

2  Set  all  port  speeds  to  lock  at  2  Gb/s. 

4  Set  all  port  speeds  to  lock  at  4  Gb/s. 

For  -lb_mode  set  to  0  or  1 ,  the  following  speed  modes  are 
available  to  test  the  speed  negotiation: 

3  Set  all  even  ports'  speed  for  auto-negotiate.  Set  all  odd 
ports'  speed  for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  auto-negotiate.  Set  all  odd 
ports'  speed  for  2  Gb/s. 

5  Set  all  odd  ports'  speed  for  auto-negotiate.  Set  all  even 
ports'  speed  for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  auto-negotiate.  Set  all  even 
ports'  speed  for  2  Gb/s. 

For  -lb_mode  set  to  2,  the  following  speed  modes  are  available  to 
test  FIFO  underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports' 
speed  for  1  Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports' 
speed  for  2  Gb/s. 

-ports  itemlist      Specifies  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in 
the  specified  slot  (--slot)  are  used.  See  itemList  for  further 
details.  If  all  ports  in  the  ASIC  pair  are  not  specified,  only  paths 
between  selected  ports  are  tested. 

ASIC-pair  0:  -ports  0-15 

ASIC-pair  1:  -ports  16-31 

ASIC-pair  2:  -ports  32-47 

ASIC-pair  3:  -ports  48-63 
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Examples 

To  run  a  functional  test  on  slot  1  using  external  (SERDES)  loopback: 

switch : admin>  minicycle  --slot  1  -lb_mode  2 


Running  minicycle 


One  moment 

please  .  .  . 

Path 

0   .  .  . 

Spinning  . . . 

Path 

1  ... 

Spinning  . . . 

Path 

2  ... 

Spinning  . . . 

Path 

3  ... 

Spinning  . . . 

Path 

4  ... 

Spinning  . . . 

Path 

5   .  .  . 

Spinning  . . . 

Path 

6   .  .  . 

Spinning  . . . 

Path 

7  ... 

Spinning   . . . 

Test 

Complete:  minicycle  Pass  1  of  1 

Duration  0 

hr,    1  min  &  4  sec  (0:1:4:409). 

passed. 

To  run  a  functional  test  on  ports  0,  1,  2,  and  8  using  port  loopback: 

switch : admin>  minicycle  -ports  0,1,2,8  -lb_mode  1 

Back 

Plane 

Loop  Back  mode  is  ON. 

Running  mini  Cycle   

One  moment 

please  .  .  . 

Path 

0   .  .  . 

Spinning  . . . 

Path 

1  ... 

skipped. 

Path 

2  ... 

skipped. 

Path 

3  ... 

skipped. 

Path 

4  ... 

skipped. 

Path 

5   .  .  . 

skipped. 

Path 

6   .  .  . 

Spinning  . . . 

Path 

7  ... 

Spinning  . . . 

Test 

Complete:    "minicycle"  Pass  1  of  1 

Duration  0 

hr,    0  min  &  23  sec  (0:0:23:100). 

passed. 
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Diagnostics 

When  it  detects  failures,  the  test  reports  one  or  more  of  the  following  error  messages: 

DATA 

EPI1_STATUS_ERR 


ERR_ 

_STATS_2LONG 

ERR_ 

_STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR_ 

_STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2  LONG 

ERR_ 

_STAT_BADEOF 

ERR_ 

_S  TAT_B  ADO  S 

ERR_ 

_STAT_C3DISC 

ERR_ 

_STAT_CRC 

ERR_ 

_STAT_ENC IN 

ERR_ 

_STAT_ENCOUT 

ERR_ 

_STAT_TRUNC 

FDET_PERR 
FINISH_MSG_ERR 
FTPRT_STATUS_ERR 
INIT 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

PORT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 
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See  also 

backport 
camTest 

centralMemoryTest 

cmeraRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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minisPropShow 

Displays  ASIC  pair  properties. 

Synopsis 

minispropshow   [ slotnumber/] asicpair   |    [--slot  slotnumber]  -all 

Availability 

all  users 

Description 

Use  this  command  to  display  the  ASIC  pair  properties. 


NOTE:  This  command  is  not  intended  for  normal  user  operation  and  is  available  to  provide 
supplemental  information  during  system  debug. 


Operands 

The  operands  are  as  follows: 

slotnumber /asicpair        Specifies  the  index  of  the  ASIC  pair  within  the  specified  blade  to 

be  displayed.  If  slotnumber  is  not  provided,  the  current  slot  is 
assumed. 

--slot  slotnumber  -all     Specifies  the  slot  on  which  to  operate.  The  default  is  0  and  and 

designed  to  operate  on  fixed-port-count  products. 

Examples 

To  display  all  index  1  ASIC  pair  properties: 

switch :user>  minispropshow  1  -all 

slot:   1,  minis :  0 

[2/16] 

<0, 1657/0001  1,1657/0001> 

(be, 5)    (be, 4)    (be, 3)    (be, 2)    (be,l)    (be,0)    (bi,55)  (bi,54) 
(bi,25)    (bi,24)    (bi,41)    (bi,40)    (fe,3)    (fe,2)    (fe,l)  (fe,0) 

slot:    1,   minis :  1 

[2/16] 

<2, 1657/0001  3,1657/0001> 

(be, 11)    (be, 10)    (be, 9)    (be, 8)    (be, 7)    (be, 6)    (bi,39)  (bi,38) 
(bi,9)    (bi,8)    (bi,57)    (bi,56)    (fe,7)    (fe,6)    (fe,5)  (fe,4) 

(continued  on  next  page) 
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JbXUL  .      X  ,      Lll±Ll±j  . 

9 

z 

ro  /1  (\i 

l  Z /  ID  J 

<4, 1657/0001  5, 

1657/0001> 

(be, 17)    (be, 16) 

(be, 15)    (be, 14) 

(be, 13) 

(be, 12) 

(bi,23) 

(bi, 22) 

( DX , X  X  J     ^  DX , X  U  J 

/■U-i       CQ\        /Ki       CO  \ 

ire, ii) 

I  re, lu) 

( re , y ) 

I  re , o ) 

o±UL  .     X  ,     IlL±I1J-0  . 

L  Z  /  X  D  J 

<6, 1657/0001  7, 

1657/0001> 

(be, 23)    (be, 22) 

(be, 21)    (be, 20) 

(be, 19) 

(be, 18) 

(bi,7) 

(bi,6) 

(bi,27)  (bi,26) 

(bi,43)  (bi,42) 

(fe, 15) 

(fe, 14) 

(fe, 13) 

(fe,12) 

See  also 

none 
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msCapabilityShow 


Displays  the  Management  Server  (MS)  capabilities. 

Synopsis 

mscapabilityshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  supported  capabilities  of  the  Management  Server  for  each  switch  in  the 
fabric.  An  asterisk  displays  next  to  the  name  of  the  local  switch. 

'2^f  NOTE:    Reliable  commit  service  (RCS)  is  a  fabric-wide  capability  and  is  supported  only  if  all  the  switches 
in  the  fabric  support  RCS. 


Operands 

none 

Examples 

To  display  Management  Server  capability  on  a  fabric: 

switchl :user>  mscapabilityshow 

Switch  WWN  Capability  Name 


10:00:00:60:69:20:15:71  0x0000008f  "switchl"* 
10:00:00:60:69:00:30:05         0x0000008f  "switch2" 

Capability  Bit  Definitions: 
Bit  0 


Bit  1 
Bit  2 
Bit  3 
Bit  4 
Bit  5 
Bit  6 
Bit  7 
Bit  8 


Basic  Config  Service  Supported. 
Platform  Management  Service  Supported. 
Topology  Discovery  Service  Supported. 
Unzoned  Name  Service  Supported. 
Fabric  Zone  Service  Supported. 
Fabric  Lock  Service  Supported. 
Time  Service  Supported. 
RSCN  Small  Payload  Supported. 
Reliable  Commit  Service (RCS)  Supported. 


Others:  Reserved. 


Done . 
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See  also 

msConf igure 

ms  P lMgmt Ac t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 

msTdReadConf ig 
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msConfigure 

Configures  the  Management  Server  (MS)  access  control  list  (ACL). 

Synopsis 

msconf igure 

Availability 

admin 

Description 

Use  this  command  to  configure  the  MS  ACL.  MS  allows  a  SAN  management  application  to  retrieve  and 
administer  the  fabric  and  interconnect  elements,  such  as  switches.  This  application  is  located  at  the  Fibre 
Channel  well-known  address,  OxFFFFFA. 

If  the  MS  ACL  is  empty  (default),  MS  is  available  to  all  systems  connected  to  the  fabric.  By  populating  the 
MS  ACL  with  one  or  more  world  wide  names  (WWNs),  access  to  MS  is  restricted  to  those  WWNs  only. 

This  command  is  interactive  and  provides  the  user  with  the  following  menu  of  choices: 

Done  (with  the  administration) 

2.  Display  the  ACL 

3.  Add  member  based  on  its  port/ node  WWN 

4.  Delete  member  based  on  its  port/node  WWN 

If  the  MS  ACL  is  changed  by  adding  or  deleting  WWNs,  an  additional  prompt  is  given  asking  if  the  MS 
ACL  should  be  saved  to  nonvolatile  storage.  The  saved  MS  ACL  becomes  effective  upon  reboot. 

The  MS  ACL  is  implemented  on  a  per-switch  basis  and  should  be  configured  on  the  switch  to  which  the 
management  application  is  directly  connected. 

r2^f  NOTE:  When  security  is  enabled,  the  MS  ACL  is  not  used.  In  such  a  case,  access  to  MS  is  controlled  by 
t— I    security  by  way  of  the  MS_POLICY  configuration. 


Operands 

none 

Examples 

To  display  the  MS  ACL: 


switch 

admin>  msconfigure 

0 

Done 

1 

Display  the  access  list 

2 

Add  member  based  on  its  Port/Node  WWN 

3 

Delete  member  based  on  its  Port/Node  WWN 

select 

:    (0..3)    [1]  1 

(continued  on  next  page) 

348   Fabric  OS  commands 


MS  Access  List 

consists  of    ( 5 ) :  { 

20:01: 

00:60: 

69  : 

00  :  60 

:  10 

20 : 02  : 

00:60: 

69  : 

00:60 

:10 

20:03  : 

00:60: 

69  : 

00:60 

:10 

20  :  02  : 

00:60: 

69  : 

00  :  60 

:  03 

20:02: 

00:60: 

69  : 

00:60 

:  15 

0 

Done 

1 

Display  the 

access  list 

2 

Add 

member  based  on  its  Port/Node  WWN 

3 

Delete 

member  based  on  its  Port/Node  WWN 

select 

:  (0. 

.3) 

[1] 

0 

done  . 

See  also 

msCapabi 1 i  tyShow 

msPlatShow 

msPlClearDB 

ms  P lMgmt Ac t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 

msTdReadConf ig 

secPolicyShow 
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msPlatShow 

Displays  the  Management  Server  (MS)  platform  database. 

Synopsis 

msplatshow 

Availability 

all  users 

Description 

Use  this  command  to  display  information  from  the  MS  platform  database.  This  command  displays  the 
name  of  each  platform  object  with  the  platform  type  (GATEWAY,  HOST_BUS_ADAPTER,  and  so  forth), 
associated  management  addresses,  and  associated  node  names. 

Operands 

none 

Examples 

To  display  the  MS  platform  database  for  a  fabric: 

switch : admin>  msplatshow 


Platform  Name:    [9]    "first  obj " 
Platform  Type:   5   :  GATEWAY 
Number  of  Associated  M.A. :  1 
Associated  Management  Addresses : 
[35 ]    "http : /  /  java . sun . com/products /plugin" 
Number  of  Associated  Node  Names:  1 
Associated  Node  Names : 
10:00:00:60:69:20:15:71 


Platform  Name:    [10]    "second  obj" 
Platform  Type:    7    :  HOST_BUS_ADAPTER 
Number  of  Associated  M.A. :  1 
Associated  Management  Addresses : 
[30 ]    "http : / / java . sun . com/products /l " 
Number  of  Associated  Node  Names:  2 
Associated  Node  Names : 
10:00:00:60:69:20:15:79 
10:00:00:60:69:20:15:75 
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See  also 

msCapabi 1 i  tyShow 

msConf igure 

msPlatShowDBCB 

msPlClearDB 

ms P lMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 
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msPlatShowDBCB 

Displays  the  Management  Server  (MS)  platform  service  database  control  block. 

Synopsis 

msplatshowdbcb 

Availability 

all  users 

Description 

Use  this  command  to  display  the  control  block  fields  associated  with  the  platform  database. 

Operands 

none 

Examples 

To  display  the  MS  platform  service  database  control  block: 

switch : admin>  msplatshowdbcb 

Domain      Worldwide  Name  Retry  Count     Exchange  Status 


3:    10:00:00:60:69:51:10:e6  0  0x2 


msPlDBCB.peerWwn  ==  00:00:00:00:00:00:00:00. 
msPlDBCB.psPeerWwn  ==  00:00:00:00:00:00:00:00. 
msPlDBCB . replicate  ==  0. 
msPlDBCB. fabMaySeg  ==  2  55. 
msPlDBCB. enabled  ==  1. 

See  also 

msCapabi 1 i  tyShow 
msConf igure 
msPlatShow 
msPlClearDB 
msPlMgmt Activate 
msPlMgmtDeactivate 
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msPlClearDB 


Clears  the  Management  Server  (MS)  platform  database  on  all  switches  in  the  fabric. 


Use  this  command  to  clear  the  MS  platform  database  on  all  switches  in  the  fabric.  Because  this  operation 
is  nonrecoverable,  it  should  not  be  used  unless  it  is  intended  to  resolve  a  database  conflict  between  two 
joining  fabrics  or  to  establish  an  entirely  new  fabric  with  an  empty  database. 


ptyf  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  clear  the  MS  platform  database: 

switch : admin>  msplcleardb 


MS  Platform  Service  is  currently  enabled. 

This  will  erase  MS  Platform  Service  Database  in  the  entire  fabric. 
Would  you  like  to  continue  this  operation?    (yes,   y,   no,   n) :    [no]  y 

Request  to  MS  Platform  DB  Clear  operation  in  progress  

*Completed  clearing  MS  Platform  Service  Database!! 


msCapabi 1 i  tyShow 
msConf igure 
msPlatShow 
msPlatShowDBCB 
ms P lMgmt Ac  t  i va  t  e 
msPlMgmtDeactivate 


Synopsis 


msplcleardb 


Availability 


admin 


Description 


See  also 
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ms  PlMg  mtActi  vate 


Activates  the  Management  Server  (MS)  platform  service. 


Synopsis 


msplmgmtactivate 


Availability 


admin 


Description 


Use  this  command  to  activate  the  MS  platform  service  in  the  entire  fabric.  This  command  attempts  to 
activate  the  MS  platform  service  for  each  switch  in  the  fabric.  If  successful,  the  change  takes  effect 
immediately  and  commits  to  the  change  to  nonvolatile  storage  of  each  switch.  After  successful  activation, 
all  switches  in  the  fabric  boot  with  the  MS  platform  service  enabled. 

By  default,  the  MS  platform  service  is  disabled. 

Before  issuing,  run  the  msCapabilityShow  command  to  verify  all  switches  in  the  fabric  support  MS 
platform  service;  otherwise,  the  command  fails. 


[2^f  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


none 


Examples 


To  activate  the  MS  platform  service: 


switch : admin>  msplmgmtactivate 


Request  to  activate  MS  Platform  Service  in  progress 


*Completed  activating  MS  Platform  Service  in  the  fabric! 


See  also 


msCapabi 1 i  tyShow 


msPlatShow 


msPlClearDB 


msPlMgmtDeactivate 
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msPlMgmtDeactivate 

Deactivates  the  Management  Server  (MS)  platform  service. 

Synopsis 

msplmgmtdeactivate 

Availability 

admin 

Description 

Use  this  command  to  deactivate  the  MS  platform  service  in  the  entire  fabric.  This  command  deactivates 
the  MS  platform  service  for  each  switch  in  the  fabric  and  commits  the  change  to  nonvolatile  storage.  After 
a  successful  deactivation,  all  switches  in  the  fabric  boot  with  the  MS  platform  service  disabled. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 
Operands 

none 

Examples 

To  deactivate  the  MS  platform  service  on  all  switches  in  the  fabric: 


switch : admin>  msplmgmtdeactivate 

MS  Platform  Service  is  currently  enabled. 

This  will  erase  MS  Platform  Service  configuration 
information  as  well  as  database  in  the  entire  fabric. 

Would  you  like  to  continue  this  operation?    (yes,   y,   no,   n) : 

[no]  y 

Request  to  deactivate  MS  Platform  Service  in  progress  

*Completed  deactivating  MS  Platform  Service  in  the  fabric ! 

See  also 

msCapabi 1 i  tyShow 

msConf igure 

msPlatShow 

msPlatShowDBCB 

msPlClearDB 

ms P lMgmt Ac  t  i va  t  e 
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msTdDisable 

Disables  the  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstddisable  ["ALL"] 

Availability 

admin 

Description 

Use  this  command  to  disable  the  management  server  topology  discovery  service  of  a  local  switch  or  an 
entire  fabric.  This  change  takes  effect  immediately  and  commits  to  the  configuration  database  for  all 
switches;  therefore,  persistent  across  power  cycles  and  reboots. 

If  the  "all"  operand  is  used,  this  command  attempts  to  disable  the  topology  discovery  service  on  all 
switches  in  the  fabric. 


NOTE:  When  security  is  enabled,  and  using  the  "all"  operand,  this  command  can  be  issued  only  from 
the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operand: 

"all"  Disables  the  MS  topology  discovery  service  throughout  the  entire 

fabric.  This  operand  is  optional. 

Examples 

To  disable  the  MS  topology  discovery  service  on  the  local  switch  only: 


switch : admin>  mstddisable 

This  may  erase  all  NID  entries.     Are  you 

sure?  (yes, 

y,   no,   n) : 

[no]  y 

Request  to  disable  MS  Topology  Discovery 

Service  in 

progress . . . 

done . 

*MS  Topology  Discovery  disabled  locally. 

To  disable  MS  topology  discovery  on  all  the  switches  in 

the  fabric: 

switch : admin>  mstddisable  "ALL" 

This  may  erase  all  NID  entries.     Are  you 

sure?  (yes, 

y,   no,   n) : 

[no]  y 

Request  to  disable  MS  Topology  Discovery 

Service  in 

progress .  .  . 

done . 

*MS  Topology  Discovery  disabled  locally. 

*MS  Topology  Discovery  Disable  Operation 

Complete ! ! 
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See  also 

msTdEnable 
msTdReadConf ig 
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msTdEnable 

Enables  the  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstdenable  ["ALL"] 

Availability 

admin 


Description 

Use  this  command  to  enable  the  MS  topology  discovery  service  on  a  local  switch  or  on  the  entire  fabric. 
This  change  takes  effect  immediately  and  commits  to  the  configuration  database  for  all  affected  switches. 

If  the  operand  "all"  is  used,  this  command  attempts  to  enable  the  MS  topology  discovery  service  on  all 
switches  in  the  fabric. 


NOTE:  When  security  is  enabled,  and  using  the  "all"  operand,  this  command  can  be  issued  only  from 
the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operand: 

"all"  Enables  the  MS  topology  discovery  service  throughout  the  entire 

fabric.  This  operand  is  optional.. 

Examples 

To  enable  the  MS  topology  discovery  service  on  the  local  switch  only: 


switch: admin>  mstdenable 

Request  to  enable  MS  Topology  Discovery 

Service  in  progress. . . . 

done . 

*MS  Topology  Discovery  enabled  locally. 

To  enable  MS  topology  discovery  on  all  the  switches  in 

the  fabric: 

switch : admin>  mstdenable  "ALL" 

Request  to  enable  MS  Topology  Discovery 

Service  in  progress. . . . 

done . 

*MS  Topology  Discovery  enabled  locally. 

*MS  Topology  Discovery  Enable  Operation 

Complete ! ! 

See  also 

msTdDisable 
msTd.Read.Conf  ig 
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msTdReadConfig 


Displays  the  status  of  Management  Server  (MS)  topology  discovery  service. 

Synopsis 

mstdreadconf ig 

Availability 

all  users 

Description 

Use  this  command  to  check  whether  or  not  the  management  server  topology  discovery  service  is  enabled. 

Operands 

none 

Examples 

To  display  the  status  of  the  topology  discovery  service: 

switch :admin>  mstdreadconf ig 

*MS  Topology  Discovery  is  enabled. 

See  also 

msCapabi 1 i  tyShow 

msConf igure 

ms  P lMgmt Ac  t  i va  t  e 

msPlMgmtDeactivate 

msTdDisable 

msTdEnable 
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myld 

Displays  the  current  login  session  details. 

Synopsis 

my  id 

Availability 

admin 

Description 

Use  this  command  to  display  the  status  of  the  system  and  the  login  session  details. 
The  login  session  gives  details  of  the  following: 

•  CP/switch  (or  console/serial  port)  used  to  log  in 

The  IP  address  of  the  current  login  session  for  telnet  or  the  name  of  the  current  console  port  or  the 
serial  port  (if  modem  login  used) 

•  The  current  CP's  mode  (Active,  Standby,  or  Unknown) 

•  The  current  system  status  (Redundant,  Non-Redundant,  or  Unknown). 

Operands 

none 

Examples 

To  display  current  login  information: 


switch : admin>  myid 

Current  Switch: 

switch 

Session  Detail: 

switch   (123.123.123.123)  Active  Redundant 

See  also 

version 
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nbrStateShow 

Displays  FSPF  neighbor's  state. 

Synopsis 

nbrstateshow   [ slotnumber/]  [portnumber] 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  neighbors  to  the  local  switch,  or  information  about  a 
specific  neighbor  if  a  port  number  is  supplied.  FSPF  defines  a  neighbor  as  a  remote  EPort  interface  that 
is  directly  attached  to  the  local  switch.  The  following  fields  display: 

Local  Domain  ID  Domain  number  of  local  switch. 

Local  Port  E  Port  (interface)  on  local  switch. 

Domain  Domain  number  of  remote  switch. 

Remote  Port  E_Port  (interface)  on  remote  switch. 

State  State  of  the  neighbor.  The  E_Port  is  used  to  route  frames 

only  if  the  neighbor  is  in  NB_ST_FULL  state. 

Operands 

This  command  has  the  following  optional  operands: 

slotnumber       For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 
followed  by  a  slash  (/). 

portnumber       Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed  systems. 

Use  switchShow  to  list  valid  ports.  If  this  operand  is  omitted,  all 
neighbor  states  are  displayed. 

Examples 

To  display  information  about  switches  directly  connected  to  the  local  switch: 


switch :user> 

nbrstateshow 

2/0 

Local  Domain 

ID:  1 

Local  Port 

Domain 

Remote  Port 

State 

16 

2 

48 

NB_ST_FULL 

See  also 

interf aceShow 
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nbrStatsClear 


Resets  FSPF  interface  counters. 

Synopsis 

nbrstatsclear    [ slotnumber/]  [portnumber] 

Availability 

admin 

Description 

Use  this  command  to  reset  the  counters  of  FSPF  frames  transmitted  and  received  on  each  inter-switch  link 
(ISL)  or  a  specific  ISL.  These  counters  display  using  the  using  the  interf  aceShow  command. 

Use  this  command  without  operands  to  reset  counters  on  all  interfaces. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 
followed  by  a  slash  (/). 

portnumber       Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed  systems. 

Use  switchShow  to  list  valid  ports.  This  operand  is  optional;  if  omitted, 
FSPF  statistics  are  reset. 

When  this  command  is  specified  with  no  operand,  the  statistics  are  cleared  for  all  interfaces. 

Examples 

To  reset  the  counters  on  a  port: 

switch : admin>  interf aceshow  1/0 

idbP  =  0xl0050a38 

Interface  0  data  structure: 

nghbP  =  0xl004ce68 

if No  =  0 

masterPort  =  0  (self) 

defaultCost  =  500 

cost  =  500 

delay  =  1 

(continued  on  next  page) 
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(output  truncated) 

nCmdAcc 

= 

J  1 

nlnvCmd 

= 

n 
u 

nHloIn 

= 

i  n 

A.  U 

nlnvHlo 

= 

n 

nLsuIn 

= 

nLsaln 

= 

i  n 

attHloOut 

= 

1  1 

nHloOut 

= 

1  1 

attLsuOut 

1  9 

nLsuOut 

12 

attLsaOut 

17 

nLsaOut 

17 

switch : admin> 

nbrstatsclear 

1/0 

switch : admin> 

interf aceshow 

1/0 

idbP 

Oxl0050a3J 

! 

Interface  0  data  structure: 

nghbP 

0xl004ce66 

> 
5 

if  No 

0 

masterPort 

0  (self) 

def aultCost 

500 

cost 

500 

(output  truncated) 

nCmdAcc 

0 

nlnvCmd 

0 

nHloIn 

0 

nlnvHlo 

0 

nLsuIn 

0 

nLsaln 

0 

attHloOut 

0 

nHloOut 

0 

attLsuOut 

0 

nLsuOut 

0 

attLsaOut 

0 

nLsaOut 

0 
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See  also 

interf aceShow 

portShow 

switchShow 
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nodeFind 

Displays  all  the  device  Name  Server  (NS)  entries  matching  a  given  WWN,  device  PID,  or  alias. 

Synopsis 

node  find  WWN  \    PID   \  ALIAS 

Availability 

all  users 

Description 

Use  this  command  to  display  the  NS  information  for  all  the  devices  in  the  fabric  that  have  either  a  port 
world  wide  name  (WWN)  or  a  node  WWN  matching  with  the  given  WWN;  or  have  a  device  PID 
matching  with  the  given  PID;  or  have  a  defined  configuration  alias  to  which  the  device  belongs  matching 
with  the  given  alias. 

The  message  No  device  is  found  displays  if  there  is  no  device  matching  the  given  WWN,  PID,  or 
alias. 

Operands 

This  command  has  the  following  operand: 

WWN  |   pid  |  alias     Specify  the  WWN,  device  PID,  or  alias  that  can  be  used  to  match 

the  real  device's  data.  WWN  must  have  eight  colon-separated  fields, 
each  consisting  of  one  or  two  hexadecimal  digits  between  0  and  ff, 
with  no  spaces.  PID  must  begin  with  Ox  or  OX;  otherwise,  it 
interprets  as  an  alias. 
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Examples 

To  display  all  the  device  information  matching  the  given  data: 

switch : admin>  nodefind  a320 

Local : 

Type  Pid        COS  PortName  NodeName  SCR 

NL       0314d9;  3 ; 22 : 00 : 00 : 04 : cf : 5d : dc : 2d; 2 0 : 00 : 0 0 : 04 : cf : 5d : dc : 2d;  0 

FC4s:    FCP    [SEAGATE  ST318452FC  0001] 

Fabric  Port  Name:  20:14:00:60:69:80:04:79 

Permanent  Port  Name:   22 : 00 : 00 : 04 : cf : 5d : dc : 2d 

Device  type:  Physical  Target 

Aliases:  a320 

NL       0314d6;  3 ; 22 : 00 : 00 : 04 : cf : 9f : 78 : 7b; 20 : 00 : 00 : 04 : cf : 9f : 78 : 7b;  0 

FC4s:    FCP    [SEAGATE  ST336605FC  0003] 
Fabric  Port  Name:  20:14:00:60:69:80:04:79 
Permanent  Port  Name:   22  :  00 : 00 : 04 : cf : 9f : 78 : 7b 
Device  type:  Physical  Target 
Aliases:  a320 

NL       0314d5;  3 ; 22 : 00 : 00 : 04 : cf : 9 f : 7d : eO ; 2 0 : 00 : 0 0 : 04 : cf : 9f : 7d : eO ;  0 

FC4s:    FCP    [SEAGATE  ST336605FC  0003] 
Fabric  Port  Name:  20:14:00:60:69:80:04:79 
Permanent  Port  Name:   22 : 00 : 00 : 04 : cf : 9f : 7d: eO 
Device  type:  Physical  Target 
Aliases:  a320 

NL       0314d4;  3 ; 22 : 00 : 00 : 04 :cf : 9f :26 : 7e;20 : 00 : 00 : 04 :cf : 9f :26 :7e;  0 

FC4s:    FCP    [SEAGATE  ST336605FC  0003] 
Fabric  Port  Name:  20:14:00:60:69:80:04:79 
Permanent  Port  Name:   22  :  00 : 00 : 04 : cf : 9f : 26 : 7e 
Device  type:  Physical  Target 
Aliases:  a320 


To  display  all  the  device  information  matching  the  given  WWN: 


switch : admin>  nodefind  20:00:00:e0: 

8b: 

01: 

ce: 

d3 

Remote : 

Type  Pid        COS  PortName 

NodeName 

NL       020eef;             3 ; 20 : 00 : 00 : eO : 

8b 

:01: 

:  ce  : 

: d3 ; 2  0 : 00 : 00 : eO : 8b : 01 : ce : d3 ; 

Fabric  Port  Name:  20:0e:00: 

60  : 

69  : 

51: 

0b:ba 

Permanent  Port  Name:  20:00: 

00  : 

eO  : 

8b: 

01:ce:d3 

Device  type:  Physical  Target 

Aliases : 
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To  display  all  the  device  information  matching  the  given  PID: 


switch : admin>  nodefind  0x020eef 

Remote : 

Type  Pid        COS  PortName 

NodeName 

NL       020eef;             3 ; 20 : 00 : 00 : eO 

:  8b 

:  01 

:  ce 

: d3 ; 20 : 00 : 00 : eO : 8b : 01 : ce : d3 ; 

Fabric  Port  Name:  20:0e:00: 

:60: 

69: 

:51: 

0b:ba 

Permanent  Port  Name:  20:00: 

:00: 

e0: 

:8b: 

01:ce:d3 

Device  type:  Physical  Target 

Aliases : 

To  display  all  the  device  information  matching  the  given  no  match: 


switch : admin>  nodefind  abed 
No  device  found. 

See  also 

aliShow 
nsAllShow 
nscamShow 
nsShow 
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nsAliasShow 


Displays  local  Name  Server  (NS)  information,  with  aliases. 

Synopsis 

nsaliasshow   [ -r  -t] 

Availability 

all  users 

Description 

Use  this  command  to  display  local  name  server  information  with  the  added  feature  of  displaying  the 
defined  configuration  aliases  to  which  the  device  belongs. 

The  following  message  is  displayed  if  there  is  no  information  in  this  switch: 

There  is  no  entry  in  the  Local  Name  Server 
The  command  nsAllShow  displays  information  from  all  switches. 

The  display  resulting  from  this  command  is  identical  to  the  command  nsAllShow,  with  the  exception  of 
an  additional  line  listing  to  which  the  aliases  the  device  belongs.  If  there  are  no  defined  configuration 
aliases  for  that  device,  no  alias  is  displayed. 

Operands 

This  command  has  the  following  operands: 

-r  Replaces  the  time-to-live  (TTL)  attribute  output  with  state  change  registration 

(SCR)  information  in  the  display.  This  value  indicates  what  type  of 
registered  state  change  notification  (RSCN)  a  device  registers  to  receive. 
Values  include: 

SCR=0  Reserved. 

SCR=1  Fabric  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  by  the  fabric  controller  for 
events  detected  by  the  fabric. 

SCR=2  NxPort  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  for  events  detected  by  the 
affected  Nx_Port. 

SCR=3  Register  to  receive  all  RSCN  request  issued.  The 

RSCN  request  returns  all  affected  N  PortJD  pages. 

-t  Displays  the  device  type.  Of  the  two  device  type  parts,  the  first  part 

indicates  the  origination  of  the  device.  Currently,  four  originations  are 
defined: 

Physical  Device  connected  to  the  Nx  Port,  using  FLOGI  to 

login  to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx  Port,  using  FDISC  to  log 

in  to  the  switc 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 

(initiator/target) 
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Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target         Both  a  SCSI  initiator  and  a  SCSI  target 

Examples 

To  display  local  NS  information  with  aliases: 

switch : admin>  nsAliasShow 
{ 

Type  Pid        COS  PortName  NodeName  TTL(sec) 

N         021200;  2  ,  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19  ;  na 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 
Permanent  Port  Name:  10:00:00:60:69:00:03:19 
Aliases : 

N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  na 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:   10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 

Aliases:  DeviceAlias 
NL       0214e2;  3 ; 2 1 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : le ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 00 : 2 1 : le 

Aliases : 

NL       0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 00 : 2 1 : el 

Aliases:  MyAliasl  MyAlias2 
NL       0214e8;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 04 : 83 : c9 ; 2 0 : 0 0 : 0 0 : f a : ce : 04 : 83 : c9 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 04 : 83 : c9 

Aliases : 

NL       0214ef;  3 ; 2 1 : 0 0 : 00 : ad : be : 04 : 6 f : 7 0 ; 2 0 : 00 : 0 0 : ad : be : 04 : 6 f : 7 0 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric  Port  Name:  20:04:00:60:69:01:44:22 
Permanent  Port  Name:   21 : 00 : 00 : ad : be : 04 : 6f : 70 
Aliases : 

The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  aliases  with  -r  option: 


switch : admin>  nsAliasShow  -r 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric   Port  Name:  20:02:00:60:69:01:44:22 
Permanent  Port  Name:  10:00:00:60:69:00:03:19 
Aliases : 

N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric   Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:   10  :  00 : 00 : 60 : 69 : 00 : 02  : d6 

Aliases:  DeviceAlias 
NL        0214e2;  3  ;  2 1 :  0 0  :  0 0  :  f a  :  ce : 0 0 : 2 1 : le ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 :  le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21:00:00: fa :ce:00:21:le 

Aliases : 

NL        0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 00 : 2 1 : el 

Aliases:  MyAliasl  MyAlias2 
NL       0214e8;  3 ; 2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric   Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 04 : 83 : c9 

Aliases : 

NL       0214ef;  3;21:00:00:ad:bc:04:6f : 7 0 ; 2 0 : 00 : 0 0 : ad : be : 04 : 6 f :70;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric   Port  Name:  20:04:00:60:69:01:44:22 
Permanent  Port  Name:   21 : 00 : 00 : ad : be : 04 : 6f : 7 0 
Aliases : 

The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  aliases  with  -rand  -t  options: 

switch : admin>  nsAliasShow  -r  -t 

{ 

Type  Pid        COS  PortName  NodeName  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60  :  69  :  00  :  03  : 19  ;  3 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 
Permanent  Port  Name:  10:00:00:60:69:00:03:19 
Device  type:   Physical  Unknown (initiator/ target) 
Aliases : 

N         021300;  3;10:00:00:60:69:00:02:d6;20:00:00:60:69:00:02:d6;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:   10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 

Device  type:  NPV  Initiator 

Aliases:  DeviceAlias 
NL       0214e2;  3 ; 2 1 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 00 : 0 0 : f a : ce : 0 0 : 2 1 : le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21:00:00: fa :ce:00:21:le 

Device  type:  Physical  Target 

Aliases : 

NL       0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 00 : 2 1 : el 

Device  type:  Physical  Target 

Aliases:  MyAliasl  MyAlias2 
NL       0214e8;  3 ; 2 1 : 0 0 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 0 0 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 04 : 83 : c9 

Device  type:  Physical  Target 

Aliases : 

NL       0214ef;  3 ; 2 1 : 0 0 : 0 0 : ad : be : 04 : 6 f : 7 0 ; 2 0 : 0 0 : 0 0 : ad : be : 04 : 6 f : 7 0 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 
Fabric  Port  Name:  20:04:00:60:69:01:44:22 
Permanent  Port  Name:   21 : 00 : 00 : ad : be : 04 : 6f : 70 
Device  type:  Physical  Target 
Aliases : 

The  Local  Name  Server  has  6  entries  } 

See  also 

nsAllShow 

nsShow 

switchShow 
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nsAllShow 

Displays  global  name  server  information. 

Synopsis 

nsallshow  [type] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  24-bit  Fibre  Channel  addresses  of  all  devices  in  all  switches  in  the 
fabric.  If  the  type  operand  is  supplied,  only  devices  of  specified  FC-PH  type  are  displayed.  If  type  is 
omitted,  all  devices  are  displayed. 

'2^f  NOTE:    Specifying  the  type  operand  causes  the  switch  to  send  out  a  query  to  every  switch  in  the  fabric. 
On  a  large  fabric  you  should  not  run  a  script  that  repeatedly  issues  the  nsAllShow  command  with  a 
type  operand  specified. 


Operands 

This  command  has  the  following  operand: 

type  Specify  the  FC-PH  type  code.  This  operand  is  optional.  The  valid  values 

for  this  operand  are  0  to  255.  Following  are  two  specific  FC-PH  device 
type  codes: 

8  =  FCP  type  device 

4,5  =  FC-IP  type  device 

Other  FC-PH  types  are  displayed  in  the  format  x  ports  supporting 
FC4  code,  where  x  is  the  number  of  ports  of  a  type  and  code  is  the 
FC-PH  type  code. 

Examples 

To  display  all  devices  in  the  fabric,  followed  by  all  type  8  (SCSI-FCP)  devices  and  all  type  5  (SCSI-FCIP) 


devices: 


switch : admin>  nsallshow 

12  Nx_Ports  in  the  Fabric  { 

011200  0118e2  0118e4  0118e8  0118ef  021200 

0214e2  0214e4  0214e8  0214ef 

} 

switch: admin>  nsallshow  8 
8  FCP  Ports  { 

0118e2  0118e4  0118e8  0118ef  0214e2  0214e4  0214e8  0214ef 
} 

switch : admin>  nsallshow  5 

2  FC-IP  Ports  in  the  Fabric  { 
011200  021200} 
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See  also 

nsShow 
switchShow 
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nscamShow 

Displays  information  about  remote  devices  in  the  Name  Server  (NS)  cache. 

Synopsis 

nscamshow  [-t] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  local  NS  cache  information  about  the  devices  discovered  in  the  fabric 
by  the  NS  cache  manager. 

The  message  No  Entry  found!  displays  if  the  NS  cache  manager  does  not  discover  new  switches  or 
new  devices  in  the  fabric. 

For  each  remote  switch  found,  the  output  of  this  command  displays  the  domain  number,  state,  revision, 
owner,  and  a  list  of  devices  for  that  domain  number.  For  each  device  found  in  the  devices  list,  the 
following  information  is  displayed: 


Type  U  for  unknown,  N  for  N  Port,  NL  for  NL  Port 

Pid  The  24-bit  Fibre  Channel  address 

COS  A  list  of  classes  of  service  supported  by  the  device 

PortName  The  device's  port  world  wide  name  (WWN) 

NodeName  The  device's  node  WWN 


Permanent  Port  Name       Physical  N_Port  or  NL_Port  WWN 
There  might  be  additional  lines  if  the  device  has  registered  FC4s  supported  and  fabric  port  name. 

Operands 

The  operand  is  as  follows: 

-t  Specify  to  display  the  device  type.  Of  the  two  device  type  parts,  the  first 

part  indicates  the  origination  of  the  device.  Currently,  four  originations 
are  defined: 

Physical  Device  connected  to  the  Nx  Port,  using  FLOGI  to 

login  to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx  Port,  using  FDISC  to  log 

in  to  the  switch 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 
(initiator/target) 

Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target  Both  a  SCSI  initiator  and  a  SCSI  target 
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Examples 

To  display  all  switch  and  device  entries  discovered  by  the  NS  in  the  fabric: 


switch : admin>  nscamShow 

nscam  show  for  remote  switches: 
Switch  entry  for  2 

state      rev  owner 
known        v43  0  OxfffcOl 
Device  list:   count  1 

Type  Pid        COS  PortName  NodeName 

N  021200; 

2,3;10:00:00:60:69:00:ab:ba;10:00:00:60:69:00:ab:ba; 
FC4s:  FCIP 

PortSymb:    [28]    "SEAGATE  ST318452FC  0001" 
Fabric  Port  Name:  20:02:00:60:69:00:68:19 
Permanent  Port  Name:   10 : 00 : 00 : 60 : 69 : 00 : ab : ba 

Switch  entry  for  4 
state    rev  owner 
known      v32  0  OxfffcOl 
Device  list:   count  0 
No  entry  is  found! 

To  display  the  output  with  -t  option: 

switch : admin>  nscamShow  -t 

nscam  show  for  remote  switches: 
Switch  entry  for  2 

state       rev  owner 
known        v43  0  OxfffcOl 
Device  list:  count  1 

Type  Pid        COS  PortName  NodeName 

N  021200; 

2,3  ;10:00:00:60:69:00:ab:ba; 10:00:00:60:69:00: ab:ba ; 
FC4s:  FCIP 

PortSymb:    [28]    "SEAGATE  ST318452FC  0001" 
Fabric  Port  Name:  20:02:00:60:69:00:68:19 
Permanent  Port  Name:   10  :  00 : 00 : 60 : 69 : 00 : ab : ba 
Device  type:   Physical  Initiator 

Switch  entry  for  4 
state     rev  owner 
known      v32  0  OxfffcOl 
Device  list:   count  0 
No  entry  is  found! 

See  also 

nsAHShow 
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nsShow 
switchShow 
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nsShow 


Displays  local  Name  Server  (NS)  information. 


Synopsis 


nsshow   [ -r  -t] 


Availability 

all  users 

Description 

Use  this  command  to  display  local  NS  information  about  devices  connected  to  this  switch. 

The  following  message  is  displayed  if  there  is  no  information  in  this  switch: 

There  is  no  entry  in  the  Local  Name  Server 
The  nsAllShow  command  displays  information  from  all  switches. 


Each  line  of  output  displays: 

Type 
PID 

COS 

PortName 
NodeName 
TTL 


U  for  unknown,  N  for  N_Port,  NL  for  NL_Port. 
24-bit  Fibre  Channel  address. 
List  of  classes  of  service  supported  by  device. 
Device  port  world  wide  name  (WWN). 
Device  node  WWN. 

Time-to-live,  in  seconds,  for  cached  entries  or  NA  (not 
applicable)  if  the  entry  is  local.  This  displays  if  the  -r  option  is 
given. 

State  change  registration  of  the  device.  This  displays  if  the  -r 
option  is  given. 

Device  type  if  -t  is  given. 


SCR 

Device  type 

Permanent  Port  Name       Physical  N_Port  or  NL_Port  WWN. 

There  might  be  additional  lines  if  the  device  has  registered  any  of  the  following  information  (the  switch 
automatically  registers  SCSI  inquiry  data  for  FCP  target  devices): 

FC4s  supported 

IP  address 

I  PA 

Port  and  node  symbolic  names 

Fabric  Port  Name.  This  is  the  WWN  of  the  port  on  the  switch  to  which  the  device  is  physically 
connected. 

Hard  address  and/or  port  IP  address 
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Operands 

This  command  has  the  following  operands: 


Replaces  the  TTL  attribute  output  with  SCR  (state  change  registration) 
information  in  the  display.  This  value  indicates  what  type  of  RSCN  a  device 
registers  to  receive.  Values  include: 

SCR=0  Reserved. 

SCR=1  Fabric  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  by  the  fabric  controller  for 
events  detected  by  the  fabric. 

SCR=2  NxPort  detected  registration.  Register  to  receive  all 

RSCN  requests  issued  for  events  detected  by  the 
affected  Nx  Port. 

SCR=3  Register  to  receive  all  RSCN  request  issued.  The  RSCN 

request  returns  all  effected  N  PortJD  pages. 

Displays  the  device  type.  Of  the  two  device  type  parts,  the  first  part 
indicates  the  origination  of  the  device.  Currently,  four  originations  are 
defined: 

Physical  Device  connected  to  the  Nx  Port,  using  FLOGI  to  login 

to  the  switch 

Virtual  Contrived  device  by  the  switch 

NPV  Device  connected  to  the  Nx_Port,  using  FDISC  to  log  in 

to  the  switch 

iSCSI  Device  connected  to  the  iSCSI  port 

The  second  part  indicates  the  role  of  the  device.  Currently,  four  roles  are 
defined: 

Unknown  Device  role  is  not  detected 
(initiator/target) 

Initiator  A  SCSI  initiator 

Target  A  SCSI  target 

Initiator+Target  Both  a  SCSI  initiator  and  a  SCSI  target 
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Examples 

To  display  local  NS  information: 


switch : admin>  nsShow 
{ 

Type  Pid        COS  PortName  NodeName  TTL(sec) 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 3 0 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  na 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 

Permanent  Port  Name:  10:00:00:60:69:00:03:19 
N         021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  na 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:  10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 
NL       0214e2;  3 ; 21 : 00 : 00 : f a : ce : 00 : 2 1 : le ; 2 0 : 00 : 00 : f a : ce : 00 : 21 : le ;  na 

FC4s:   FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  2 1 : 00 : 00 : f a : ce : 00 : 2 1 : le 
NL       0214e4;  3 ; 21 : 00 : 00 : f a : ce : 00 : 2 1 : el ; 2 0 : 00 : 00 : f a : ce : 00 : 21 : el ;  na 

FC4s:   FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  21:00:00: fa :ce:00:21: el 
NL       0214e8;  3 ; 21 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  na 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 
NL       0214ef;  3 ; 21 : 00 : 00 : ad : be : 04 : 6f : 70 ; 2 0 : 00 : 00 : ad : be : 04 : 6f : 70 ;  na 

FC4s:   FCP    [STOREX     RS2999FCPH3  JB09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : ad:bc : 04 : 6f : 70 


The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  -r: 


switch : admin>  nsShow  -r 
{ 

Type  Pid        COS  PortName  Node-Name  SCR 

N         021200;  2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ;  3 

FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 

Permanent  Port  Name:  10:00:00:60:69:00:03:19 
N  021300;  3 ; 10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 2 0 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:  10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 
NL       0214e2;  3 ; 21 : 00 : 00 : f a : ce : 00 : 21 : le ; 20 : 00 : 00 : f a : ce : 00 : 2 1 : le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  21:00:00: fa :ce:00:21:le 
NL       0214e4;  3 ; 21 : 00 : 00 : f a : ce : 00 : 21 : el ; 20 : 00 : 00 : f a : ce : 00 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  21:00:00: fa :ce:00:21: el 
NL       0214e8;  3 ; 21 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 20 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:  2 1 : 00 : 00 : f a : ce : 04 : 83 : c9 
NL       0214ef;  3 ; 21 : 00 : 00 : ad: be : 04 : 6f : 70 ; 20 : 00 : 00 : ad : be : 04 : 6f : 70 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   2 1 : 00 : 00 : ad: be : 04 : 6f : 70 


The  Local  Name  Server  has  6  entries  } 
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To  display  local  NS  information  with  -r  and  -t: 


switch : admin>  nsShow  -r  -t 
{ 

Type  Pid        COS  PortName  NodeName  SCR 

N        021200;         2 , 3 ; 10 : 00 : 00 : 60 : 69 : 00 : 03 : 19 ; 30 : 00  :  00  :  60 : 69  :  00  :  03  : 19  ;  3 
FC4s:  FCIP 

Fabric  Port  Name:  20:02:00:60:69:01:44:22 

Permanent  Port  Name:  10:00:00:60:69:00:03:19 

Device  type:   Physical  Unknown(initiator/target) 
N         021300;  3  ;  10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ; 20 : 00 : 00 : 60 : 69 : 00 : 02 : d6 ;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:   10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 

Device  type:   Physical  Initiator 
N         021301;  3;10:00:00:60:69:00:02:d7;20:00:00:60:69:00:02:d7;  1 

Fabric  Port  Name:  20:03:00:60:69:01:44:22 

Permanent  Port  Name:   10 : 00 : 00 : 60 : 69 : 00 : 02 : d6 

Device  type:  NPIV  Initiator 
NL       0214e2;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : le ; 2 0 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : le ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  MT09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 00 : 2 1 : le 

Device  type:  Physical  Target 
NL       0214e4;  3 ; 2 1 : 0 0 : 0 0 : f a : ce : 0 0 : 2 1 : el ; 2 0 : 0 0 : 00 : f a : ce : 0 0 : 2 1 : el ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  CD09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 0  0 : 0  0 : f a : ce : 0 0 : 2 1 : el 

Device  type:  Physical  Target 
NL       0214e8;  3 ; 21 : 00 : 00 : f a : ce : 04 : 83 : c9 ; 2 0 : 00 : 00 : f a : ce : 04 : 83 : c9 ;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  NS09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : f a : ce : 04 : 83 : c9 

Device  type:  Physical  Target 
NL       0214ef;  3  ;  21 :  00  :  00 :ad:bc : 04 : 6f : 7 0 ; 2 0 : 0 0 : 00 : ad : be : 04 : 6 f :70;  0 

FC4s:    FCP    [STOREX     RS2999FCPH3  JB09] 

Fabric  Port  Name:  20:04:00:60:69:01:44:22 

Permanent  Port  Name:   21 : 00 : 00 : ad : be : 04 : 6f : 7 0 

Device  type:  Physical  Target 

The  Local  Name  Server  has  6  entries  } 


See  also 

nsAHShow 
switchShow 
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nsZoneMember 


Displays  the  information  of  all  the  online  devices  zoned  with  the  given  device. 


Synopsis 


nszonemember  -a   I    -u   I  pid  \  wwn 


Availability 

all  users 

Description 

Use  this  command  to  display  information  about  all  the  online  devices  zoned  with  the  given  device. 
Issuing  this  command  without  operands  displays  all  online  devices  zoned  with  the  given  device.  Each  line 
of  output  displays: 

Type  U  for  unknown,  N  for  NPort,  NL  for  NLPort 

Pid  The  24-bit  Fibre  Channel  address 

COS  A  list  of  classes  of  service  supported  by  the  device 

PortName  The  device's  port  world  wide  name  (WWN) 

NodeName  The  device's  node  WWN 

Permanent  Port  Physical  N_Port  or  NL_Port  WWN 

Name 

DeviceType  The  device's  type 

There  might  be  additional  lines  if  the  device  has  registered  any  of  the  following  information  (the  switch 
automatically  registers  SCSI  inquiry  data  for  FCP  target  devices): 

FC4  supported 

IP  address  (node) 

I  PA 

port  and  node  symbolic  name  (local  device  only) 
fabric  port  name 

hard  address  and/or  port  IP  address 


Operands 


This  command  has  the  following  operands: 


pid  I  wwn 


Displays  each  local  device's  online  zoned  device  data,  including  the  PID 
and  zone  alias. 

Displays  all  the  unzoned  devices  in  the  entire  fabric.  The  device  data 
displayed  includes  the  device  PID  and  zone  alias. 

Specifies  the  port  ID  or  WWN,  respectively,  whose  zoned  devices  are  to 
be  viewed.  This  operand  is  required. 


382   Fabric  OS  commands 


Examples 

To  display  the  information  of  all  the  online  devices  zoned  with  the  given  device: 


switch : admin>  nszonemember  0x0416e2 
3  local  zoned  members : 


Type  Pid        COS  PortName  NodeName 

SCR 

NL  041901; 

2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae;  3 
Fabric  Port  Name:  20:09:00:60:69:50:06:78 
Permanent  Port  Name:   10  :  0  0 : 00 : 00 : c9 : 2 6 : Oe : ae 
Device  type:   Physical  Initiator 
NL  0416e2; 

3;22:00:00:20:37:d9:6b:b3;20:00:00:20:37:d9:6b:b3;  0 
FC4s:    FCP    [SEAGATE  ST318304FC  0005] 
Fabric  Port  Name:  20:06:00:60:69:50:06:78 
Permanent  Port  Name:   22:00:00:20:37: d9: 6b :b3 
Device  type:  Physical  Target 
NL  0416e4; 

3; 22:00:00:20:37: d9:61:ac; 20:00:00:20:37: d9:61:ac;  0 
FC4s:    FCP    [SEAGATE  ST318304FC  0005] 
Fabric  Port  Name:  20:06:00:60:69:50:06:78 
Permanent  Port  Name:   22  :  00 : 00 : 2 0 : 3 7 : d9 : 61 : ac 
Device  type:   Physical  Target 


No  remote  zoned  members 
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To  display  the  information  of  all  the  online  devices  zoned  with  the  given  WWN: 

switch : admin>  nszonemember  10 : 00 : 00 : 00 : c8 : 23 : Ob : ad 
3  local  zoned  members : 


Type  Pid        COS  PortName  NodeName 

SCR 

NL  041901; 

2,3;10:00:00:00:c9:26:0e:ae;20:00:00:00:c9:26:0e:ae;  3 
Fabric  Port  Name:  20:09:00:60:69:50:06:78 
Permanent  Port  Name:   10 : 00 : 00 : 0 0 : c9 : 2 6 : Oe : ae 
Device  type:   Physical  Initiator 
NL  0416e2; 

3 ; 22 : 00 : 00 :20 : 37 :d9 : 6b:b3 ;20 : 00 : 00 :20 : 37 :d9 : 6b:b3 ;  0 
FC4s:    FCP    [SEAGATE  ST318304FC  0005] 
Fabric  Port  Name:  20:06:00:60:69:50:06:78 
Permanent  Port  Name:   22 : 00 : 00 : 2 0 : 37 : d9 : 6b : b3 
Device  type:  Physical  Target 
NL  0416e4; 

3 ;22:00:00:20:37:d9:61:ac; 20:00:00:20:37: d9:61:ac;  0 
FC4s:    FCP    [SEAGATE  ST318304FC  0005] 
Permanent  Port  Name:   22 : 00 : 00 : 20 : 37 : d9 : 61 : ac 
Device  type:  Physical  Target 

No  remote  zoned  members 

To  display  each  local  device's  online  zoned  device  data: 


switch: 

:admin>  nszonemember  -a 

Port : 

4  Pid: 

0xb00400        Aliases:   ix3 60_131_2 01_6a 

Zoned 

Members :   2  devices 

Pid:  0xb00400 

Aliases:  ix360_131_201_6a 

Pid:  0xbalee8 

Aliases:  trimml01b_3 

Port : 

12 

Pid:  OxbOOcOl 

Aliases:  dl360_130159a 

Zoned 

Members :   2  devices 

Pid:  OxbOOcOl 

Aliases:  dl360_130159a 

Pid:  Oxbdlbef 

Aliases:  nstor4b_8 

Port : 

13 

Pid:  OxbOOdOO 

Aliases:  ix360_131_196p5 

Zoned 

Members :  2  devices 

Pid:  OxbOOdOO 

Aliases:  ix360_131_196p5 

Pid:  0xe07d00 

Aliases:  hds9200_6p4  hds9200_ 

_6p4 

Port : 

14 

Pid:  OxbOOeOO 

Aliases:  dl360_130251a  dl360_130251a 

Zoned 

Members :   2  devices 

Pid:  OxbOOeOO 

Aliases:  dl360_130251a  dl360_ 

_130251a 

Pid:  0xbalae4 

Aliases:  trimml00a_2 
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To  display  all  the  unzoned  devices  in  the  fabric: 


switch : admin>  nszonemember  -u 


Pid: 

0xb01ea9 ; 

Aliases : 

trimm32b_ 

.1 

Pid: 

OxbOleaa; 

Aliases : 

trimm32b_ 

_2 

Pid: 

OxbOleab; 

Aliases : 

trimm32b_ 

.3 

Pid: 

OxbOleac ; 

Aliases : 

trimm32b_ 

.4 

Pid: 

OxbOlfad; 

Aliases : 

trimm32a_ 

_5 

Pid: 

OxbOlfae; 

Aliases : 

trimm32a_ 

.6 

Pid: 

OxbOlfbl; 

Aliases : 

trimm32a_ 

.7 

Pid: 

0xb01fb2 ; 

Aliases : 

trimm32a_ 

.8 

Pid: 

0xdc2  800; 

Aliases : 

Totally  9  unzoned  devices  in  the  fabric. 

See  also 

cf gShow 

nscamShow 

nsShow 
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passwd 

Changes  the  password  for  a  user  level. 

Synopsis 

passwd  ["user"] 


Availability 

all  users 

Description 

Use  this  command  to  change  the  password  for  the  user  currently  logged  in  or  for  another  user.  To  change 
the  password  for  a  specific  user,  enter  the  command  with  the  optional  user  operand. 

Users  logging  in  to  the  system  by  way  of  RADIUS  are  allowed  to  change  the  passwords  of  the  roles  they 
log  in;  for  example,  if  a  user's  role  in  RADIUS  is  admin,  and  this  command  is  executed,  the  system 
prompts  for  the  old  admin  password.  This  command  changes  the  passwords  in  the  switch  database  only. 

The  hierarchy  of  user  levels  are  (from  greatest  access  to  least)  root,  factory,  admin,  and  user.  Typically, 
all  fabric  management  should  be  performed  by  admin. 

When  the  root  password  is  changed,  all  user  levels  currently  logged  in  are  terminated. 
If  the  fabric  is  not  in  secure  mode,  the  behavior  of  the  command  is  as  follows: 

•  If  you  are  changing  your  own  user-level  password,  you  are  prompted  to  enter  the  old  password  and, 
if  your  entry  is  valid,  the  new  password. 

•  If  a  you  are  changing  another  user-level  password,  you  are  prompted  to  enter  that  user  level's  old 
password  and,  if  your  entry  is  valid,  the  new  password. 

•  If  you  are  logged  in  as  the  root  user  when  changing  another  user-level  password,  you  are  not 
prompted  to  enter  the  old  password. 

•  The  command  is  disabled  until  you  have  changed  all  the  login  passwords  from  the  manufacture 
default  values. 

If  the  fabric  is  in  secure  mode,  the  behavior  of  the  command  is  as  follows: 

The  command  can  be  run  only  on  the  primary  FCS  switch.  The  changed  passwords  will  be  distributed 
to  all  FCS  switches.  Non-FCS  switches  will  be  updated  if  the  password  of  the  user  account  is 
changed. 

•  Changing  the  password  of  any  user  level  causes  the  login  session  of  that  account  (if  logged  in)  to  be 
terminated. 


NOTE:  If  the  Security  option  is  enabled  on  the  fabric,  this  command  is  disabled  on  all  switches  except 
'    the  primary  FCS.  See  the  HP  StorageWorks  Fabric  OS  5.x  administrator's  guide  for  more  information. 

A  new  password  must  follow  these  rules: 

Have  8  to  40  characters 
•    Be  different  from  the  previous  password 
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Use  the  following  keys  to  control  input: 

Return  When  entered  at  a  prompt  with  no  preceding  input,  accepts  the 

default  value  (if  applicable)  and  moves  to  the  next  prompt. 

Ctrl+D  (end-of-file)  When  entered  at  a  prompt  with  no  preceding  input,  terminates 

the  command  without  changing  the  password.  This  is  valid  on 
most  computers;  however,  your  settings  could  be  different. 

Operands 

This  command  has  the  following  operand: 

user  Specify  the  name  of  the  user,  in  quotation  marks,  for  which  you  want  to 

modify  the  password.  This  operand  is  optional.  Valid  values  are  root, 
factory,  admin,  or  user. 

You  can  only  specify  this  operand  when  you  are  logged  in  as  root, 
factory,  or  admin.  If  you  try  to  change  the  password  of  a  user  level 
higher  in  the  hierarchy  (for  example,  you  are  admin  and  attempting  to 
change  the  root  password),  you  are  prompted  to  enter  the  current 
password  of  that  level.  If  you  try  to  change  the  password  of  a  user  level 
lower  in  the  hierarchy,  you  are  not  prompted  to  enter  the  current 
password. 

Examples 

To  change  the  password  for  the  admin  user: 

switch : admin>  passwd  "admin" 
Changing  password  for  admin 
Enter  new  password: 
Re-type  new  password: 
Password  changed. 

Saving  password  to  stable  storage. 

Password  saved  to  stable  storage  successfully. 

Diagnostics 

When  failures  are  detected,  the  subtext  might  report  one  or  more  of  the  following  error  messages: 

"user"  is  not  a  valid  user  name.     You  have  not  specified  a  user  name  that  is  a 

valid,  recognized  user  name  on  the  system. 

Permission  denied.  You  do  not  have  permission  to  change  the  login 

name  or  password  specified. 

Incorrect  password.  You  have  not  entered  the  correct  password  when 

prompted  for  the  old  password. 

Password  unchanged.  You  have  entered  the  carriage  return  special  input 

case,  choosing  not  to  change  the  password. 

Passwords  do  not  match.  You  have  not  correctly  verified  the  new  password. 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

login 
logout 
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path  Info 

Display  routing  and  statistics  information  along  a  path,  covering  multiple  switches. 


Synopsis 

pathinfo  [domain]    [src_portnumber]    [dst_portnumber]  [-r] 


Availability 

admin 


Description 

Use  this  command  to  display  detailed  routing  information  from  a  source  port  or  area  on  the  local  switch 
to  a  destination  port  or  area  on  another  switch.  This  routing  information  describes  the  exact  path  that  a 
user  data  stream  takes  to  go  from  the  source  port  to  the  destination  port,  including  all  intermediate 
switches. 

The  command  does  not  make  any  retry  attempts  if  there  is  a  timeout  or  failure.  It  might  fail  if  a  switch 
along  the  path  is  busy,  for  instance,  if  a  switch  is  performing  a  warm  recovery  or  if  a  switch  along  the 
path  does  not  support  this  feature. 


r2^>  NOTE:    If  the  advanced  performance  tuning  (APT)  policy  in  effect  on  the  intermediate  switches  is  not  a 
port-based  policy,  subsequent  data  streams  might  not  take  the  same  path  as  displayed  in  the  pathinfo 
output. 

See  aptPolicy  for  more  information  on  advanced  performance  tuning  policies. 


If  you  specify  an  inactive  port  or  a  path  through  a  switch  that  does  not  have  active  routing  tables  to  the 
destination,  this  command  displays  the  path  that  would  be  used  if  the  ports  were  active.  If  you  specify  a 
destination  port  that  is  not  active,  this  command  uses  the  embedded  port  as  the  destination. 

For  bladed  systems,  the  ingress  and  egress  points  are  specified  as  area  numbers.  For  nonbladed  systems, 
ingress  and  egress  points  are  specified  as  ports.  This  agrees  with  the  representation  displayed  by  the 
switchShow  command. 

In  addition,  pathinfo  can  provide,  upon  request,  statistics  on  every  traversed  Inter-Switch  Link  (ISL)  that 
is  part  of  the  path.  This  feature  is  available  in  interactive  mode  only. 

The  routing  and  statistics  information  are  provided  by  every  switch  along  the  path,  based  on  the  current 
routing-tables  information  and  statistics  calculated  continuously  in  real-time.  Each  switch  represents  one 
hop  of  the  total  path. 

Other  options  allow  the  collection  of  information  on  the  reverse  path,  or  on  a  user  selected  path  (source 
route) . 

For  each  hop,  the  routing  information  output  includes  the  following: 
Hop  The  hop  number.  The  local  switch  is  hop  0. 

In  Port  The  port  or  area  from  which  the  switch  receives  frames.  For  hop  0, 

this  is  src_portnumber.  For  bladed  systems,  this  is  specified  as 
the  area  number;  otherwise,  it  is  the  port  number. 

Domain  ID  The  domain  ID  of  the  switch. 

Name  The  name  of  the  switch. 

Out  Port  The  output  port  that  the  frames  use  to  reach  the  next  hop.  For  the  last 

hop,  this  is  dst_portnumber.  For  bladed  systems,  this  is  specified 
as  the  area  number;  otherwise,  it  is  the  port  number. 


388   Fabric  OS  commands 


BW 


Cost 


The  bandwidth  of  the  output  ISL,  in  Gb/s.  It  does  not  apply  to  the 
embedded  port. 

The  cost  of  the  output  link  used  by  FSPF  routing  protocol.  Only 
applicable  if  the  output  link  is  currently  recognized  by  FSPF. 


When  requested,  statistics  are  reported  below  the  routing  information  for  each  hop.  These  statistics  are 
presented  for  both  the  input  and  output  ports,  for  both  receive  and  transmit  modes.  These  statistics  are 
divided  into  basic  and  extended  statistics,  which  can  be  individually  requested  in  interactive  mode. 
Statistics  are  not  reported  for  the  embedded  port. 

To  collect  these  statistics,  this  command  uses  a  special  frame,  the  pathlnf  o  frame,  that  is  sent 
hop-by-hop  from  the  source  switch  to  the  destination  switch.  In  order  to  prevent  such  a  frame  to  loop 
forever  if  an  error  occurs,  a  maximum  number  of  hops  for  the  frame  to  traverse  is  enforced.  The  hop  count 
includes  all  hops  in  the  direct  path  from  source  to  destination,  and  also  all  the  hops  in  the  reverse  path,  if 
the  tracing  of  the  reverse  path  is  requested.  The  default  value  for  the  maximum  hop  count  is  25. 


Basic  statistics 


Extended  statistics 


Reverse  path 


Source  route 


Basic  statistics  report  variables  that  give  an  indication  of  ISL 
congestion  along  the  path.  They  include  the  following: 

B/s  Bytes  per  second  received  or  transmitted;  reports  for 

multiple  time  periods,  displayed  in  parentheses. 

Txcrdz  The  length  of  time  in  milliseconds  that  the  port  has  been 

prevented  from  transmitting  frames  due  to  lack  of 
buffer-to-buffer  credit.  It  is  an  indication  of  downstream 
congestion.  This  value  reports  for  multiple  time  periods, 
displayed  in  parentheses.  Note  that  other  commands, 
such  as  portStatsShow,  might  express  this  value  in 
units  other  than  milliseconds. 

Extended  statistics  report  variables  of  general  interest.  They  include  the 
following: 

F/s  Frames  per  second  received  or  transmitted;  reports  for 

multiple  time  periods,  displayed  in  parentheses. 

Words  Total  number  of  4-byte  Fibre  Channel  words. 

Frames  Total  number  of  frames. 

Errors  Total  number  of  errors  that  might  cause  a  frame  not  to 

be  received  correctly.  This  includes  CRC  errors,  bad 
EOF  errors,  frame  truncated  errors,  frame-too-short 
errors,  and  encoding  errors  inside  a  frame. 

In  general,  the  path  from  port  A  on  switch  X  to  port  B  on  switch  Y 
might  be  different  from  the  path  from  port  B  to  port  A.  The  difference 
could  be  in  the  links  traversed  between  the  same  sequence  of 
switches,  or  the  reverse  path  might  even  involve  different  switches.  The 
-r  option  allows  the  user  to  determine  both  routing  and  statistics 
information  for  the  reverse  path,  in  addition  to  those  for  the  direct 
path. 

The  source  route  option  allows  the  user  to  specify  a  sequence  of 
switches,  ports,  or  areas  that  the  pathlnf  o  frame  has  to  traverse  to 
reach  the  destination.  Therefore,  the  path  might  be  different  from  the 
one  used  by  actual  traffic. 

The  source  route  is  expressed  as  a  sequence  of  switches,  a  sequence 
of  output  ports  or  areas,  or  a  combination  thereof.  The  next  hop  in  the 
source  route  is  described  by  either  the  output  port  or  area  to  be  used 
to  reach  the  next  hop,  or  the  domain  ID  of  the  next  hop. 
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The  source  route  can  specify  a  partial  route  from  source  to  destination 
(in  which  case  the  remaining  hops  are  chosen  as  the  path  from  the 
input  port  or  area  on  the  first  hop  not  listed  in  the  source  route  to  the 
destination),  as  a  full  route,  or  as  an  arbitrary  route  across  the  fabric. 
The  maximum  hop  count  is  enforced. 

If  the  source  route  does  not  specify  all  the  switches  along  a  section  of 
the  path,  a  further  option  allows  to  specify  a  strict  versus  a  loose  path. 
A  strict  source  route  requires  that  only  the  specified  switches  are 
reported  in  the  path  description.  If  two  switches  are  specified  back  to 
back  in  the  source  route  descriptor,  but  are  not  directly  connected,  the 
switches  in  between  will  be  ignored.  In  case  of  a  loose  source  route, 
the  switches  in  between  will  be  reported.  The  concepts  of  strict  and 
loose  route  apply  to  the  portions  of  the  path  described  by  domains, 
not  to  the  part  described  by  output  ports  or  areas. 


Operands 


The  following  operands  are  optional 


src_portnumber 


domain  ID  of  the  destination  domain.  If  omitted,  the  command  prompts 

for  all  operands,  including  whether  basic  and  extended  statistics 
should  be  included. 

Port  or  area  whose  path  to  the  destination  domain  is  sought.  The 
default  is  embedded  port  (-1).  For  bladed  systems,  the 
destination  is  specified  as  the  area;  otherwise,  it  is  the  port.  If 
the  source  port  is  -1  with  no  additional  arguments,  basic 
statistics  display  for  the  route. 

Port  or  area  on  the  destination  switch  for  each  path  being 
traced.  This  command  returns  the  state  of  this  port  or  area.  The 
default  is  embedded  port  (-1 ),  or  if  a  destination  port  is  specified 
that  is  not  active.  For  bladed  systems,  the  destination  is  specified 
as  the  area;  otherwise,  it  is  the  port. 

"-r"  Display  reverse  path  in  addition  to  forward  path. 

Without  operands,  pathinf  o  prompts  for  the  preceding  operands.  The  value  of  domain  is  mandatory; 
the  values  for  the  source  and  destination  ports  can  be  -1 ,  to  indicate  the  embedded  port.  Reverse-path 
tracing  remains  optional.  In  addition,  this  command  prompts  for  following  parameters: 


dst_portnumber 


max  hops 
basic  stats 
extended  stats 
source  route 


strict  source  rte 


Timeout 


The  maximum  number  of  hops  that  the  pathinf  o  frame  is 
allowed  to  traverse;  default  is  25. 

Requests  the  reporting  of  basic  statistics  on  every  link;  default  is 
no. 

Requests  the  reporting  of  extended  statistics  on  every  link; 
default  is  no. 

Specifies  a  sequence  of  switches  or  ports  that  the  pathinf  o 
frame  should  traverse;  default  is  no.  Note  that  if  an  output  port 
(or  area)  to  the  next  hop  is  specified,  the  user  is  not  prompted  for 
the  domain  of  the  next  switch,  which  is  determined  by  the  port 
(or  area)  specified. 

Specifies  that  the  source  route  must  be  followed  strictly  as 
indicated,  skipping  possible  intermediate  switches.  When  using 
this  option,  the  source  route  hops  must  be  specified  using 
domain  rather  than  output  port. 

The  maximum  time  allowed  to  wait  for  the  response;  default  is 
1 0  seconds. 
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Examples 


To  display  basic  path  information  to  a  specific  domain,  using  the  command  line  (noninteractive  mode): 


switch : admin>  pathinfo  91 
Target  port  is  Embedded 


Hop     In  Port     Domain  ID   (Name)             Out  Port 

BW 

Cost 

0              E                  9    (web226)  2 
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1000 
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tr. 

switch : admin>  pathinfo 

Max  hops:    (1. .127)  [25] 
Domain:    (1..239)    [-1]  8 

Source  port:    (0..15)  [-1] 

Destination  port:    (0..255)  [-1] 

Basic  stats    (yes,   y,   no,   n) :    [no]  y 

Extended  stats   (yes,  y,  no,  n) :    [no]  y 

Trace  reverse  path   (yes,   y,   no,   n) :  [no] 

Source  route   (yes,   y,   no,   n) :  [no] 

Timeout:    (1.  .30)  [5] 

Target  port  is  Embedded 

Hop     In  Port     Domain  ID   (Name)             Out  Port 

BW 

Cost 

0              E                  9    (web226)  2 

1G 

1000 

Port  E 

2 

Tx 

Rx 

Tx 

Rx 

B/S  (IS) 

— 

0 

0 

B/s  (64s) 

1 

1 

Txcrdz  (Is) 

0 

Txcrdz  (64s) 

- 

0 

F/s  (Is) 

0 

0 

F/s  (64s) 

2743 

0 

Words 

2752748 

2822763 

Frames 

219849 

50881 

Errors 

0 

(continued  on  next  page) 

Fabric  OS  5.x  command  reference  guide  391 


Hop     In  Port  Domain 
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1               ^                1  n 

X                        j                           _L  U 

(tatoK?  9  Q  ^ 

1  9 
J_  z 

i  nnn 

1UUU 

Port 

3 

12 

Tx 

P  v 
rv-X. 

Tx 

rv-X. 

±3/  S     [  -LS  J 

O  D 

/  D 

u 

n 
u 

13/  S      (,  0  4±  S  ) 

_> 

c 
_> 

c 

_> 

lAtlUZ      ^  ±  !d  / 

n 
u 

n 
u 

1  AL.I  U.Z      ^  O  ^  o  y 

n 
u 

n 
u 

f  /  S      I  -LS  J 

-L 

1 

u 

u 

r/fc>      \  0  4±  h>  / 

n 
u 

n 
u 

n 
u 

n 
u 

9  Ad  A^  AHI  £ 

zy uy u j  u 

9  9  Q  A  7  1 

91 1 QQC1 

91  91  7  £  7 
Z  _L  Z  _L  /  O  / 

Frames 

20025929 

54999 

162338 

56710 

Errors 

4 

0 

rlU^J        _LI1    rUi  L  UOILLCT.-LI1 

J.  1J      ^  IN  CT-LLLt:  y 

UU.L     Jr OX  U 

Dill 
-DVV 

<^Oo  L- 

2             14  8 

(web22  8) 

E 

( output  truncated) 

See  also 

port Stats Show 
switchShow 
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pdShow 

Displays  data  from  a  panic  dump  file. 

Synopsis 

pdshow  [panic-dump- file] 

Availability 

admin 

Description 

Use  this  command  to  display  data  from  a  panic  dump  file.  The  panic  dump  file  contains  information  that 
might  be  useful  to  determine  the  cause  of  the  system  panic. 

When  executed  without  any  arguments,  this  command  displays  output  from  the  latest  panic  dump  file 
available  on  the  switch. 

If  a  panic  dump  file  is  specified  as  an  argument,  the  contents  of  that  specific  file  are  displayed. 

Operands 

This  command  has  the  following  operand: 

panic-dump- file  Specify  the  full  path  name  of  a  panic  dump  file.  This  operand  is 

optional. 

Examples 

To  examine  a  panic  dump  file  by  the  name  panic_dump  located  under  the  directory  /tmp: 

switch: admin>  pdshow  / tmp/panic_dump 

***  CAUTION  *** 

*  Host     PLATFORM      (current)    is:  'Unknown' 

*  PLATFORM  got  from  pd  file  is:  'SW12000' 

*  Some  results  shown  may  be  incorrect  and/or  missing 

*  It  is  best  if  this  command  is  run  on  same  PLATFORM  as  that  of  pdfile 

************** 

******** 

*  File       : /core_f iles/panic/core . pdl03 89323 52  * 

*  SECTION: PD_MISC  * 
 ********  

WatchDogRegister=OxO 

Section=Startup  time:   Tue  Dec     3   16:06:11  UTC  2002 

Kernel=  2.4.19 

Fabric  OS=     v4 . 1 . 0_j_dist_1103 

Made  on=         Tue  Dec  3  19:07:13  2002 

Flash=  Tue  Dec  3   13:19:06  2002 

BootProm=  3.2.0 

Section=HA  show  Output 

(output  truncated) 
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See  also 

portLogDump 
saveCore 
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perf Add  EEMon  itor 


Adds  an  end-to-end  monitor  to  a  port. 

Synopsis 

perf addeemonitor  [ slotnumber/] portnumber  SourcelD  DestID 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license 


Description 

Use  this  command  to  add  an  end-to-end  performance  monitor  to  a  port.  The  performance  monitor  counts 
the  number  of  words  received,  number  of  words  transmitted,  and  number  of  CRC  errors  detected  using 
either  of  the  following  two  conditions: 

*  For  frames  received  at  the  port,  the  frame  SID  is  the  same  as  SourcelD  and  frame  DID  is  the  same  as 
DestID,  both  RX_COUNT  and  CRC_COUNT  will  be  updated  accordingly.  Note  that  the 
CRC_COUNT  counts  the  CRC  errors  detected  with  the  frames  received  at  or  transmitted  from  the 
associated  port. 

•  For  frames  transmitted  from  the  port,  the  frame  DID  is  the  same  as  SourcelD  and  frame  SID  is  the 
same  as  DestID,  both  TXCOUNT  and  CRC_COUNT  will  be  updated  accordingly. 

To  monitor  traffic  from  host  A  to  device  B,  add  a  monitor  on  port  2,  specifying  0x050200  as  the  SID  and 
0x01 01 00  as  the  DID.  The  RX  count  equals  the  number  of  words  from  host  A  to  device  B,  whereas  the  TX 
count  equals  the  number  of  words  from  device  B  to  host  A.  The  CRC  count  equals  the  total  number  of 
CRC  errors  for  both  directions.  Adding  a  monitor  on  port  1,  specifying  0x010100  as  SID  and 
0X050200  as  the  DID  has  a  similar  effect,  except  the  RX  and  TX  counts  are  interchanged. 

If  ISL  monitoring  is  enabled,  end-to-end  monitors  cannot  be  added  to  E_Ports.  Existing  end-to-end  monitors 
on  E_Ports  are  deleted. 

Identical  monitors  cannot  be  added  to  the  same  port.  Two  monitors  are  considered  identical  if  they  have 
the  same  SID  and  DID  values  after  applying  the  end-to-end  mask. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  performance  monitors. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


SourcelD 


For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 
added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow  for  a 
list  of  valid  ports. 

Specify  the  3-byte  SID  (Source  ID)  of  the  originator  device.  It  should 
be  in  OxDDAAPP  format,  where  DD  is  domain  ID,  AA  is  area  ID  and 
PP  is  AL  PA  ID.  For  example,  0x050200  has  a  domain  ID  of  5,  an 
area  ID  of  2,  and  an  AL_PA  ID  of  0.  SourcelD  and  DestID  both 
cannot  be  0x000000. 
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DestiD  Specify  the  3-byte  DID  (destination  ID)  of  the  destination  device.  It 

should  be  in  OxDDAAPP  format,  where  DD  is  domain  ID,  AA  is  area 
ID  and  PP  is  AL_PA  ID.  For  example,  0x050200  has  a  domain  ID  of 
5,  an  area  ID  of  2,  and  an  AL  PA  ID  of  0.  SourceiD  and  DestiD 
both  cannot  be  0x000000. 

Optionally,  a  comma  can  separate  the  operands.  SourceiD  and  DestJDalso  can  be  enclosed  in 
quotation  marks.  A  space  is  required  to  separate  the  operands  even  when  using  commas. 

Examples 

To  add  an  end-to-end  monitor  to  blade  1  port  2: 

switch : admin>  perf addeemonitor  1/2   "0x050200"  "0xll82ef" 
End-to-End  monitor  number  0  added. 

See  also 

perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
perf ClearEEMoni tor 
perf DelEEMoni tor 
perf ShowEEMoni tor 
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perfAddlPMonitor 


Adds  a  filter-based  performance  monitor  for  IP  frame  count. 

Synopsis 

perf addipmonitor  [slotnumber/] portnumber  [alias] 

Availability 

admin 


t^f  NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  IP  traffic  frames.  Only  frames 
transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  is  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  displayed 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

The  operands  are  as  follows: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  IP 

Frame . 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 


Examples 

To  add  an  IP  monitor  to  a  port: 


switch :admin>  perf addipmonitor  1/4  "IP_MONITOR" 
IP  traffic  frame  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddReadMonitor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddReadMonitor 


Adds  a  filter-based  performance  monitor  for  the  SCSI  Read  command. 

Synopsis 

perf addreadmonitor  [slotnumber/] portnumber  [alias] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  Read  commands  in 
Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI 
Read. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  SCSI  read  monitor  to  a  port: 

switch : admin>  perf addreadmonitor  2/4  "SCSI_R" 
SCSI  Read  filter  monitor  #2  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perf  Add  RWMonitor 


Adds  a  filter-based  performance  monitor  for  the  SCSI  read  and  write  commands. 

Synopsis 

perf addrwmonitor    [ slotnumber/] portnumber  [alias] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  Read  and  Write 
commands  in  Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI  R/W. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  SCSI  read  and  write  monitor  to  a  port: 

switch : admin>  perf addrwmonitor  2/4  "SCSI_RW" 
SCSI  Read/Write  monitor  #1  is  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddSCSIMonitor 


Adds  a  filter-based  performance  monitor  for  SCSI  frame  count. 

Synopsis 

perf addscsimonitor    [ slotnumber/] portnumber  [alias] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  traffic  frames.  Only  frames 
transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is  SCSI 
Frame. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 


Examples 

To  add  a  SCSI  traffic  frame  monitor  to  a  port: 


switch : admin>  perf addscsimonitor  2/4  "SCSI_FR" 
SCSI  traffic  frame  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perfAddUserMonitor 


Adds  a  user-defined  filter-based  performance  monitor. 


Synopsis 


perf addusermonitor  [slotnumber/] portnumber  " grouplist"  [alias] 


Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  a  custom  filter  for  frame  offsets  and  values. 

For  every  offset,  each  group  of  comparison  values  is  OR-ed  together  to  determine  a  match.  If  there  are 
multiple  offsets,  each  resulting  OR  function  is  AND-ed  to  determine  if  the  entire  statement  is  true,  thus 
incrementing  the  counter. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias  is 
also  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be  retrieved 
with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port  including  user  defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor.  In  addition,  there  should  be  no  more  than 
six  different  offsets  for  each  filter  and  no  more  than  four  different  values  per  offset  defined  by  the  user. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


"grouplist1 


For  bladed  systems  only,  this  operand  specifies  the  slot  number  of 
the  port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash 
(/)■ 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 
added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow 
for  a  list  of  valid  ports. 

Specify  up  to  six  sets  of  offset,  mask,  and  ValueList,  separated  by 
semicolons  (;). 

The  entire  grouplist  operand  must  be  enclosed  in  quotation  marks. 
This  operand  is  required. 

For  example: 

4,    Oxff,    0x22;    12,    Oxff,  0x01 

The  grouplist  component  values  are  as  follows: 

Offset        Specify  the  offset  within  the  frame.  Offset  0  is  the  first 
byte  of  the  SOF,  and  offset  4  is  the  first  byte  of  the 
frame  header.  The  offset  must  be  in  decimal  format. 
Valid  values  for  offset  are  0,  [4-63].  Offset  0  is  a 
special  case  that  can  be  used  to  monitor  the  first  four 
bytes  SOFx  frames.  EOF  cannot  be  monitored. 
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Mask         Specify  the  mask  value  to  be  applied  (AND-ed)  to 
frame  contents. 

ValueList     Specify  up  to  four  values  that  need  to  be  captured 
from  frame  contents.  The  ValueList  can  be  either 
hexadecimal  or  decimal  format. 

SOFx  frames  are  considered  a  special  case.  The  Offset  is  specified 
as  0x0;  valueList  values  are  specified  with: 


0 

SOFf 

1 

SOFcl 

2 

SOFil 

3 

SOFnl 

4 

SOR2 

5 

SOFn2 

6 

SOR3 

7 

SOFn3 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a 

maximum  of  1 0  characters.  It  might  be  surrounded  by  quotation 
marks  in  order  to  include  spaces.  This  operand  is  optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  add  a  filter-based  monitor  for  all  Extended  Link  Service  requests  (R_CTL=0x22  and  TYPE=0x01 )  to  a 
port: 

switch : admin>  perf addusermonitor  1/4   "4,    Oxff,    0x22;   12,    Oxff,  0x01" 
User  monitor  #0  added 

As  a  special  case,  to  add  a  filter-based  monitor  for  SOFi3  to  a  port: 

switch : admin>  perf addusermonitor  1/4   "0,    Oxff,  6" 
User  monitor  #1  added 

See  also 

perf AddEEMoni tor 
perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddWriteMonitor 
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perfAddWriteMonitor 


Adds  a  filter-based  performance  monitor  for  the  SCSI  write  command. 

Synopsis 

perf addwritemonitor  [slotnumber/] portnumber  [alias] 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  define  filter-based  monitors  to  count  the  number  of  SCSI  FCP  write  commands  in 
Fibre  Channel  frames.  Only  frames  transmitted  are  counted. 

After  a  successful  execution  of  this  command,  a  monitor  number  is  displayed.  The  monitor  number  is 
provided  for  manipulation  of  these  filter-based  performance  monitors.  The  optional  user-defined  alias 
also  is  displayed,  if  one  was  specified.  All  valid  monitor  numbers  and  user-defined  aliases  can  be 
retrieved  with  the  perf  ShowFilterMonitor  command. 

The  maximum  number  of  filters  is  eight  per  port,  including  user-defined  filters,  read  filters,  write  filters, 
read/write  filters,  SCSI  frame  monitor,  and  IP  frame  monitor. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

alias  Specify  a  name  for  this  monitor.  This  string  truncates  to  a  maximum  of  1 0 

characters.  It  might  be  surrounded  by  quotation  marks,  in  order  to 
include  spaces.  This  operand  is  optional.  The  default  alias  is 

SCSI_Write. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 


Examples 

To  add  a  SCSI  Write  command  monitor  to  a  port: 


switch : admin>  perf addwritemonitor  2/4  "SCSI_W" 
SCSI  Write  filter  monitor  #0  added 
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See  also 

perf AddEEMonitor 
perf AddlPMonitor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
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perfCfgClear 

Clears  the  previously  saved  performance  monitoring  configuration  settings  from  nonvolatile  memory. 

Synopsis 


perf cf gclear 


Availability 

admin 


\-$  NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  clear  the  previously  saved  end-to-end  and  filter  configuration  settings  of 
performance  monitoring  from  nonvolatile  memory. 

Operands 

none 

Examples 

To  clear  the  performance  monitoring  information  from  nonvolatile  memory: 

switch : admin>  perf cf gclear 

This  will  clear  Performance  Monitoring  settings  in  FLASH. 

The  RAM  settings  won't  change.  Do  you  want  to  continue?  (yes,  y,  no,  n) : 
[no]  y 

Please  wait  . . . 

Performance  Monitoring  configuration  cleared  from  FLASH. 

See  also 

perf Cf gRes tore 
perf Cf gSave 
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perfCfg  Restore 

Restores  performance  monitoring  configuration  settings  from  nonvolatile  memory. 

Synopsis 

perf cf grestore 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  restore  the  performance  monitoring  configuration  information  from  nonvolatile 
memory.  This  does  not  restore  the  information  cleared  using  the  perf  Cf  gClear  command;  rather,  it 
restores  the  configuration  on  nonvolatile  memory.  Any  configuration  changes  that  were  not  saved  are  lost 
using  the  perf  Cf  gRestore  command. 

Operands 

none 

Examples 

To  restore  the  performance  monitoring  configuration  information  from  nonvolatile  memory: 


switch : admin>  perf cf grestore 

This  will  overwrite  current  Performance  Monitoring 

settings 

in  RAM.   Do  you  want  to  continue?    (yes,   y,   no,   n) : 

[no]  y 

Please  wait  . . . 

Performance  monitoring  configuration  restored  from 

FLASH . 

See  also 

perf Cf gClear 
perf Cf gSave 
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perfCfgSave 

Saves  performance  monitoring  configuration  settings  to  nonvolatile  memory. 

Synopsis 

perf cf gsave 

Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  save  the  current  end-to-end  and  filter  configuration  settings  of  performance 
monitoring  into  nonvolatile  memory.  This  enables  the  performance  monitoring  configuration  to  be  saved 
across  power  cycles. 

Operands 

none 

Examples 

To  save  the  current  performance  monitoring  configuration  to  firmware: 

switch : admin>  perf cf gsave 

This  will  overwrite  previously  saved  Performance  Monitoring 
settings  in  FLASH.  Do  you  want  to  continue?    (yes,  y,   no,   n) :    [no]  y 
Please  wait  . . . 

Performance  monitoring  configuration  saved  in  FLASH. 


See  also 

perf Cf gClear 
perf Cf gRes tore 
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perfClearEEMonitor 


Clears  statistics  counters  of  an  end-to-end  performance  monitors. 

Synopsis 

perf cleareemonitor    [ slotnumber/] portnumber  [monitorld] 

Availability 

admin 


\-^<    NOTE:   This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorClear  instead. 


Description 

Use  this  command  to  clear  statistics  counters  for  all  end-to-end  performance  monitors  on  a  port,  or  an 
end-to-end  monitor  associated  with  a  specific  monitorld. 

Issuing  portStatsClear  on  a  port  also  results  in  all  end-to-end  monitors  clearing. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  clear.  Monitor  numbers  are  defined  when 
created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
cleared. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  statistics  counters  for  an  end-to-end  monitor: 

switch : admin>  perf cleareemonitor  1/2  5 
End-to-End  monitor  number  5  counters  are  cleared 

switch : admin>  perf cleareemonitor  1/2 

This  will  clear  ALL  EE  monitors'   counters  on  port  2,   continue?   (yes,  y, 
no,   n) : 

[no]  y 


412   Fabric  OS  commands 


See  also 

perf AddEEMonitor 
perf ShowEEMonitor 
perfMonitorClear 
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perfClearFilterMonitor 


Clears  statistics  counters  of  a  filter-based  performance  monitors. 

Synopsis 

perf clearf iltermonitor    [slotnumber/] portnumber  [monitorld] 

Availability 

admin 


j^j^  NOTE:   This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorClear  instead. 


Description 

Use  this  command  to  clear  statistics  counters  for  all  filter-based  performance  monitors  on  a  port,  or  a 
filter-based  monitor  associated  with  a  specific  monitorld. 

Issuing  portStatsClear  on  a  port  also  results  in  all  filter-based  monitors  clearing. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  clear.  Monitor  numbers  are  defined  when 
created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
cleared. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  statistics  counters  for  a  filter-based  monitor: 

switch : admin>  perf clearf iltermonitor  1/2  4 
Filter-based  monitor  number  4  counters  are  cleared 

switch : admin>  perf clearf iltermonitor  1/2 

This  will  clear  ALL  filter-based  monitors'  counters  on  port  2,  continue? 
(yes,  y 

,   no,   n)  :    [no]  y 
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See  also 

perf AddUserMonitor 
perfShowFilterMon.it  or 
perfMonitorClear 
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perfClrAlpaCrc 

Clears  the  CRC  error  count  associated  with  a  port  and  arbitrated  loop  physical  address  (ALPA). 

Synopsis 


perf clralpacrc    [ slotnumber/] portnumber  [ALPA] 


Availability 

admin 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  clear  a  specific  CRC  error  counter  associated  with  a  specific  port  and  AL  PA,  or  all 
such  counters  on  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

ALPA  Specify  the  AL_PA  address  if  you  want  to  clear  the  CRC  error  counter  for 

a  particular  device.  This  operand  is  optional;  if  omitted,  this  command 
clears  the  counters  for  all  devices  attached  to  the  specified  port. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  clear  the  CRC  count  on  a  particular  AL  PA  on  a  port  and  then  clear  the  CRC  count  for  all  AL  PAs  on  a 
port: 

switch : admin>  perf clralpacrc  2/15  0x59 

CRC  error  count  at  ALPA  0x59  on  port  31  is  cleared. 

switch : admin>  perf clralpacrc  2/15 
This  will  clear  all  ALPA  CRC  Counts  on  port  31 
Do  you  want  to  continue?    (yes,   y,   no,   n)  y 
Please  wait  . . . 

All  alpa  CRC  counts  are  cleared  on  port  31. 

See  also 

perf ShowAlpaCrc 
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perfDelEEMonitor 


Deletes  one  or  all  end-to-end  performance  monitors  from  a  port. 

Synopsis 

perf deleemonitor  [ slotnumber/] portnumber  [monitorld] 

Availability 

admin 


r>->hi 

NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  delete  an  end-to-end  performance  monitor  from  a  port,  or  all  such  monitors 
associated  with  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber      Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld        Specify  the  monitor  number  to  delete.  Monitor  numbers  are  defined 

when  created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
deleted. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  delete  an  end-to-end  monitor  on  a  port,  or  all  such  monitors: 

switch : admin>  perf deleemonitor  7/2  5 
End-to-End  monitor  number  5  deleted 

switch : admin>  perf deleemonitor  7/2 

This  will  remove  ALL  EE  monitors  on  port  2,   continue?    (yes,   y,   no,   n) : 
[no]  y 

See  also 

perf AddEEMoni tor 
perf ShowEEMonitor 
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perfDelFilterMonitor 


Deletes  one  or  all  filter-based  performance  monitors  from  a  port. 

Synopsis 

perf delf iltermonitor  [slotnumber/] portnumber  [monitorid] 

Availability 

admin 


Offi  NOTE:    This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  delete  a  filter-based  performance  monitor  from  a  port,  or  all  such  monitors 
associated  with  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorid  Specify  the  monitor  number  to  delete.  Monitor  numbers  are  defined 

when  created  and  can  be  displayed  using  perf  ShowEEMonitor.  This 
operand  is  optional.  If  not  specified,  all  monitor  counters  on  the  port  are 
deleted. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  delete  filter  monitor  4  from  a  port,  and  then  all  filter  monitors  from  the  port: 

switch : admin>  perf delf iltermonitor  2/3  4 

The  specified  filter-based  monitor  is  deleted. 

switch : admin>  perf delf iltermonitor  2/3 

This  will  remove  ALL  monitors  on  port  19,   continue?    (yes,  y,   no,   n) : 
[no]  y 

See  also 

perf AddUserMoni tor 
perf ShowFilterMonitor 
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perfHelp 

Displays  performance  monitoring  help  information. 

Synopsis 

perf help 

Availability 

all  users 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  available  performance  monitoring  help  commands. 

Operands 

none 
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Examples 

To  display  commands  related  to  performance  monitoring: 


switch : admin>  perfhelp 

perf Cf gSave 

Save  Performance  configuration  to  FLASH 

per f Cf gRes tore 
FLASH 

Restore  Performance  configuration  from 

perf Cf gClear 

Clear  Performance  settings  from  FLASH 

perf ClrAlpaCrc 

Clear  ALPA  device ' s  CRC  count 

perf ShowAlpaCrc 

Get  ALPA  CRC  count  by  port  and  ALPA 

perf AddEEMoni tor 

Add  end-to-end  monitor  to  a  port 

perf DelEEMoni tor 

Delete  an  end-to-end  monitor  on  port 

perf ClearEEMonitor 
on  a  port 

Clear  an  end-to-end  monitors '  counters 

perf ShowEEMoni tor 

Show  user-defined  end-to-end  monitors 

perf Set PortEEMask 

Set  overall  mask  for  E-to-E  monitors 

perf ShowPortEEMask 

Show  the  current  end-to-end  mask 

perf AddUserMoni tor 

Add  filter-based  monitor 

perf AddReadMoni tor 

Add  filter-based  monitor  -  SCSI  Read 

perf AddWriteMonitor 

Add  filter-based  monitor  -  SCSI  Write 

perf AddRWMoni tor 

Add  monitor  -  SCSI  Read  and  Write 

perfAddSCSIMonitor 

Add  monitor  for  SCSI  frame  count 

per  inuciirnoniuor 

Add  monitor  for  IP  traffic  frame  count 

perf DelFilterMoni tor 

Delete  filter-based  monitor 

perf ClearFilterMonitor 
a  port 

Clear  filter-based  monitors '  counters  on 

perf ShowFilterMonitor 
perfMonitorClear 

Show  filter-based  monitors 
Clear  end-to-end/f ilter-based/ISL  monitors 

perf Monitor Show 

Show  end-to-end/f ilter-based/ISL  monitors 
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perfMonitorClear 


Clears  counters  of  end-to-end,  filter-based,  and  ISL  performance  monitors  on  a  port. 

Synopsis 

perfmonitorclear  --class  monitor_class   [slotnumber/] portnumber  [monitorld] 

Availability 

admin 

Description 

Use  this  command  to  clear  counters  for  performance  monitors  on  a  port,  specified  by  class.  Monitor 
classes  include  end-to-end  monitors  (EE),  filter-based  monitors  (FIT),  and  inter-switch  link  monitors  (ISL). 

Issuing  the  portStatsClear  command  on  a  port  clears  all  end-to-end  and  filter-based  monitors  (but  not 
ISL  monitors)  for  all  the  ports  in  the  same  quad. 

Operands 

This  operands  are  as  follows: 

—  class  The  monitor  class,  which  can  be  one  of  EE  (end-to-end),  FLT 

monitor_class       (filter-based),  or  ISL  (inter-switch  link).  These  values  are  case  sensitive. 
This  operand  is  required. 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

monitorld  Specifies  the  monitor  number  to  clear.  Monitor  numbers  are  defined  are 

created,  and  can  be  displayed  using  perfMonitorShow.  This  operand 
is  optional;  if  omitted,  this  command  clears  all  monitor  counters  of  the 
appropriate  monitor_class  on  the  port.  This  operand  does  not  apply 
to  ISL  monitors. 

Examples 

To  clear  statistics  counters  for  an  end-to-end  monitor: 

switch : admin>  perfMonitorClear  --class  EE  1/2  5 
End-to-End  monitor  number  5  counters  are  cleared 

switch : admin>  perfMonitorClear  --class  EE  1/2 

This  will  clear  ALL  EE  monitors'   counters  on  port  2,  continue? 
(yes,   y,   no,   n)  :    [no]  y 
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To  clear  statistics  counters  for  a  filter-based  monitor: 

switch : admin>  perf MonitorClear  --class  FLT  1/2  4 
Filter-based  monitor  number  4  counters  are  cleared 

switch : admin>  perf MonitorClear  --class  FLT  1/2 

This  will  clear  ALL  filter-based  monitors'  counters  on  port  2,  continue? 
(yes,  y,   no,  y) :    [no]  y 

To  clear  statistics  counters  for  an  ISL  monitor: 

switch : admin>  perfMonitorClear  --class  ISL  1 

This  will  clear  ISL  monitor  on  port  1,   continue?   (yes,  y,  no,  n) :    [no]  y 

See  also 

perf AddEEMoni tor 
perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perfAddSCSIMonitor 
perf AddUserMoni tor 
perf AddWriteMonitor 
perf Monitor Show 
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perf Mon  itorShow 


Displays  end-to-end,  filter-based,  and  ISL  monitors  on  a  port. 

Synopsis 

perfmonitorshow  --class  monitor_class    [slotnumber/]portnumber  [interval] 

Availability 

all  users 

Description 

Use  this  command  to  display  previously  created  monitors  on  a  port.  Monitor  classes  include  end-to-end 
monitors  (EE),  filter-based  monitors  (FIT),  and  ISL  monitors  (ISL). 

ISL  monitors  are  automatically  activated  on  E_Ports  (not  including  trunk  slaves).  End-to-end  monitors  are 
created  using  perf AddEEMonitor.  Filter-based  monitors  are  created  using  perf AddlPMonitor, 
perf AddReadMonitor,  perf AddRWMonitor,  perf AddSCSIMonitor,  perf AddUserMonitor,  or 
perf AddWriteMonitor. 

For  end-to-end  monitors,  this  command  displays  (if  no  interval  operand  is  specified): 

Key  The  monitor  number 

SID  Sending  ID 

DID  Destination  ID 

Owner  app  Telnet  or  Web  Tools 

Owner_ip_addr  The  IP  address  of  the  originator  that  created  the  EE  monitor 

Tx_count  Number  of  FC  words  transmitted 

Rx_count  Number  of  FC  words  received 

Crc_count  Number  of  frames  with  CRC  errors 

If  you  do  not  specify  a  value  for  the  interval  operand,  this  command  displays  end-to-end  monitor 
information  and  a  cumulative  count  of  the  traffic  detected  by  the  monitor.  If  you  specify  a  value  for  the 
interval  operand,  this  command  displays  a  snapshot  of  the  traffic  at  the  specified  interval. 

For  filter-based  monitors,  this  command  can  display  (if  no  interval  operand  is  specified)  the  following: 

Key  The  monitor  number 

Alias  The  monitor  alias  name 

Owner  app  Telnet  or  Web  Tools 

Owner  ip  addr  The  IP  address  of  the  originator  that  created  the  filter  monitor 

Frame_count  Cumulative  64-bit  frame  count 

If  you  do  not  specify  a  value  for  the  interval  operand,  this  command  displays  a  cumulative  count  of 
the  traffic  detected  by  the  monitor.  If  you  specify  a  value  for  the  interval  operand,  this  command 
displays  a  snapshot  of  the  traffic  at  the  specified  interval. 

For  ISL  monitors,  the  command  displays: 

Tx_count  64-bit  cumulative  ISL  transmit  count  for  the  whole  ISL 

Num  ports  Number  of  ports  in  this  ISL 

Num_domains  Total  number  of  domains  being  monitored 

Domain  count  64-bit  cumulative  transmit  counter  for  each  individual  domain 


Fabric  OS  5.x  command  reference  guide  423 


Operands 


The  operands  are  as  follows: 


--class 

moni tor_class 

slotnumber 


portnumber 


interval 


The  monitor  class,  which  can  be  one  of  EE  (end-to-end),  FLT  (filter-based), 
or  ISL  (inter-switch  link).  This  operand  is  required. 

For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 
relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

Specifies  an  interval  in  (5  or  more)  seconds.  In  the  case  of  end-to-end 
monitor,  the  Tx  and  Rx  counts  are  in  the  unit  of  byte  when  this  operand  is 
specified.  This  operand  is  optional. 


Examples 


To  display  end-to-end  monitor  on  a  port  at  an  interval  of  every  6  seconds: 


switch : admin>  perfMonitorShow  --class  EE  4/5  6 
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0  12  3  4 


crc       Tx       Rx  crc       Tx       Rx  crc       Tx       Rx  crc       Tx       Rx  crc       Tx  Rx 


0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

53m 

4. 

.  9m 

0 

53m 

4. 

.  9m 

0 

53m 

4. 

,  9m 

0 

53m 

4, 

.  9m 

0 

53m 

0 

0 

53m 

4. 

.  4m 

0 

53m 

4. 

.  4m 

0 

53m 

4 

.  4m 

0 

53m 

4. 

.  4m 

0 

53m 

0 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4 

.  8m 

0 

53m 

0 

0 

53m 

4. 

.  6m 

0 

53m 

4. 

.  6m 

0 

53m 

4. 

.  6m 

0 

53m 

4 

.  6m 

0 

53m 

0 

0 

53m 

5. 

.  Om 

0 

53m 

5. 

.  Om 

0 

53m 

5. 

.  Om 

0 

53m 

5  . 

.  Om 

0 

53m 

0 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

0 

0 

53m 

4. 

.  5m 

0 

53m 

4. 

.  5m 

0 

53m 

4. 

.  5m 

0 

53m 

4, 

.  5m 

0 

53m 

0 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

0 

0 

52m 

5. 

.  Om 

0 

52m 

5. 

.  Om 

0 

52m 

5. 

.  Om 

0 

52m 

5, 

.  Om 

0 

52m 

0 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4  . 

.  5m 

0 

52m 

0 

0 

52m 

4. 

.  6m 

0 

52m 

4. 

.  6m 

0 

52m 

4. 

,  6m 

0 

52m 

4. 

.  6m 

0 

52m 

0 

424   Fabric  OS  commands 


To  display  EE  monitors  on  a  port: 


Switch : admin>  perf MonitorShow  --class  EE  4/5 

There  are  7  end-to-end  monitor (s)   defined  on  port  53. 

KEY  SID  DID  OWNER_APP         OWNER_IP_ADDR  TX_COUNT  RX_COUNT  CRC_COUNT 


0  0x58e0f  0xll82ef 
0x0000000000000000 


N/A 


0x0000000000000000  0x0000000000000000 


0  0x21300     0x21dda  TELNET 
0x0000000000000000 

1  0x21300     0x21ddc  TELNET 
0x0000000000000000 

2  0x21300     0x21de0  TELNET 
0x0000000000000000 

3  0x21300     0x21del  TELNET 
0x0000000000000000 

4  0x21300     0x21de2  TELNET 
0x0000000000000000 

5  0x11000  0x21fd6  WEB_TOOLS 
0x0000000000000000 

6  0x11000  0x21fe0  WEB_TOOLS 
0x0000000000000000 


N/A  0x00000004d0ba9915  0x0000000067229e65 

N/A  0x00000004d0baa754  0x0000000067229e65 

N/A  0x00000004d0bab3a5  0x0000000067229e87 

N/A  0x00000004d0bacle4  0x0000000067229e87 

N/A  0x00000004d0bad086  0x0000000067229e87 

192.168.169.40  0x00000004d0bade54  0x0000000067229e87 

192.168.169.40  0x00000004d0baed41  0x0000000067229e98 


To  display  filter-based  monitor  on  a  port  at  an  interval  of  every  6  seconds: 


switch : admin>  per fMonitorShow  --class  FLT  2/5  6 
perfmonitorshow  21,  6 
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To  display  filter  monitor  information  on  a  port: 


switch : admin> 

perfMonitorShow  --class  FLT 

2/5 

There  are  7  filter-based 

monitors  defined 

on 

port  21. 

KEY 

ALIAS 

OWNER_APP 

OWNER_IP_ADDR 

FRAME_COUNT 

0 

SCSI_Frame  TELNET 

N/A 

0x00000000002c2229 

1 

SCSI_WR 

TELNET 

N/A 

0x000000000000464a 

2 

SCSI_RW 

TELNET 

N/A 

0x000000000000fd8c 

3 

SCSI_RW 

WEB_TOOLS 

192 . 168 . 169  . 

40 

0x0000000000007ba3 

4 

SCSI_RW 

WEB_TOOLS 

192 . 168 . 169  . 

190 

0x0000000000004f0e 

5 

SCSI_RD 

WEB_TOOLS 

192 . 168 . 169  . 

40 

0x0000000000002208 

6 

SCSI_WR 

WEB_TOOLS 

192 . 168 . 169 . 

40 

0x000000000000033a 

To  display  ISL  monitor  information  on  a  port: 


switch : admin>  perfMonitorShow  --class  ISL  1/1 
Total  transmit  count  for  this  ISL:  1462326 
Number  of  destination  domains  monitored:  3 
Number  of  ports  in  this  ISL:  2 

Domain    97:  110379  Domain  98:  13965 

Domain     99:  1337982 

See  also 

perf ShowEEMonitor 
perfShowFilterMon.it  or 
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perfSetPortEEMask 


Sets  overall  mask  for  end-to-end  (EE)  performance  monitors. 

Synopsis 


perf setporteemask  [ slotnumber/] portnumber  TxSIDMsk  TxDIDMsk  RxSIDMsk 
RxDIDMsk 


Availability 

admin 


r^Sf  NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  set  the  mask  for  the  EE  performance  monitors  of  a  port.  This  command  enables  a 
user  to  selectively  choose  the  kind  of  Fibre  Channel  frames  in  which  the  number  of  words  are  to  be 
counted.  On  setting  the  EE  mask  on  a  port,  all  existing  EE  monitors  on  that  port  are  deleted. 

This  command  controls  all  three  address  fields  (domain  ID,  area  ID,  and  ALPA  ID)  of  both  the  source  ID 
and  destination  ID,  which  can  be  used  to  trigger  the  monitor. 

When  a  mask  is  set  (Oxff),  the  corresponding  field  will  be  used  to  trigger  the  monitor.  If  the  mask  is  unset 
(0x00),  the  corresponding  field  will  be  ignored. 

There  is  only  one  EE  mask  per  port.  The  mask  is  applied  to  all  eight  EE  monitors  available  on  a  port.  The 
default  EE  mask  value  upon  power-on  is  already  set.  When  ISL  monitoring  is  enabled,  EE  mask  on  E  Ports 
are  controlled  automatically  and  existing  mask  values  for  E_Ports  are  over-written. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

TxSIDMsk  Specify  the  source  ID  mask  in  dd:aa:pp  format,  with  quotation  marks,  , 

where  : 

dd  Is  the  domain  ID  mask 

aa  Is  the  area  ID  mask 

pp  Is  AL_PA  ID  mask 

Specify  the  source  ID  mask  in  dd:aa:pp  format,  with  quotation  marks,  , 
where  :dd  is  the  domain  ID  mask,  aa  is  the  area  ID  mask,  and  pp  is 
AL  PA  ID  mask. 

Specify  the  following  values  to  turn  on  or  off  a  specific  field: 

00  Specifies  that  the  field  does  not  trigger  EE  monitors. 

ff  Specifies  that  the  field  does  triggers  EE  monitors. 

TxDIDMsk  Specify  the  destination  ID  mask  in  dd:aa  :pp  format.  Quotation  marks 

are  optional.  TxDIDMsk  represents  transmitting  destination  ID  mask.  This 
operand  is  required. 
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RxSlDMsk  Specify  the  source  ID  mask  in  dd:aa:pp  format.  Quotation  marks  are 

optional.  RxSlDMsk  represents  receiving  source  ID  mask.  This  operand  is 
required. 

RxDlDMsk  Specify  the  destination  ID  mask  in  dd:aa  :pp  format.  Quotation  marks 

are  optional.  RxDlDMsk  represents  receiving  destination  ID  mask.  This 
operand  is  required. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  set  the  overall  mask  for  end-to-end  monitors  on  a  port: 

switch: admin>  perf setporteemask  1/6   "00:00:00"    "ff:ff:ff"  "00:00:ff" 
"ff :00:00" 

Changing  EE  mask  for  this  port  will  cause  ALL  EE  monitors  on  this  port 
to  be  deleted. 

continue?    (yes,  y,   no,   n) :    [no]  y 

The  EE  mask  on  port  6  is  set  and  EE  Monitors  on  this  port  are  deleted 

See  also 

perf AddEEMoni tor 
perf ShowEEMoni tor 
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perfShowAlpaCrc 

Displays  the  CRC  error  count  by  port  or  by  arbitrated  loop  physical  address  (ALPA). 

Synopsis 

perf showalpacrc    [slotnumber/] portnumber  [ALPA] 

Availability 

all  users 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  CRC  error  count  of  one  or  all  devices  attached  to  a  port.  If  the  AL  PA 
operand  is  specified,  only  the  CRC  count  for  that  AL  PA  device  is  displayed.  If  the  AL  PA  operand  is  not 
specified,  the  CRC  count  for  all  the  AL  PA  devices  on  a  specified  port  are  displayed. 

CRC  count  is  a  64-bit  counter.  When  the  count  is  over  32  bits,  the  CRC  count  value  is  displayed  in 
hexadecimal;  otherwise,  CRC  count  is  displayed  in  decimal  format. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 
port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber       Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be  added, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports. 

ALPA  Specify  the  AL  PA  address  if  you  want  to  get  the  CRC  errors  for  a 

particular  device.  This  operand  is  optional;  if  omitted,  this  command 
displays  CRC  error  counts  for  all  devices  attached  to  the  specified  port. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  display  the  CRC  error  count  for  all  AL  PA  devices  on  a  port: 

switch : admin>  perf showalpacrc  2/4 
ALPA  CRC_ERROR_COUNT 


0x01  0 

See  also 

perf ClrAlpaCrc 
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perfShowEEMonitor 


Displays  end-to-end  performance  monitor  information  on  a  port. 

Synopsis 

perf showeemonitor  [ slotnumber/] portnumber  [interval] 

Availability 

all  users 


NOTE:  This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorShow  instead. 


Description 

Use  this  command  to  display  end-to-end  monitor  information  on  a  port. 
See  perfMonitorShow  for  details  regarding  this  command's  output. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number 

of  the  port  on  which  the  monitor  is  to  be  added,  followed  by  a 
slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow 
for  a  list  of  valid  ports. 

interval  Specify  an  interval,  in  seconds  (5  or  more).  Tx  and  Rx  counts  are 

in  the  unit  of  byte  when  this  operand  is  specified.  This  operand 
is  optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 
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Examples 

To  display  end-to-end  monitor  frame  traffic  on  a  port  at  an  interval  of  every  6  seconds: 


switch: admin>  perf showeemonitor  4/5  6 
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0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

0 

53m 

4. 

.  9m 

0 

53m 

4. 

.  9m 

0 

53m 

4. 

9m 

0 

53m 

4, 

.  9m 

0 

53m 

0 

0 

53m 

4. 

.  4m 

0 

53m 

4. 

.  4m 

0 

53m 

4. 

4m 

0 

53m 

4. 

.  4m 

0 

53m 

0 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

8m 

0 

53m 

4  . 

.  8m 

0 

53m 

0 

0 

53m 

4. 

.  6m 

0 

53m 

4. 

.  6m 

0 

53m 

4  . 

6m 

0 

53m 

4, 

.  6m 

0 

53m 

0 

0 

53m 

5. 

.  0m 

0 

53m 

5. 

.  0m 

0 

53m 

5. 

0m 

0 

53m 

5  . 

.  0m 

0 

53m 

0 

0 

53m 

4. 

,  8m 

0 

53m 

4. 

.  8m 

0 

53m 

4. 

8m 

0 

53m 

4. 

.  8m 

0 

53m 

0 

0 

53m 

4 

.  5m 

0 

53m 

4. 

.  5m 

0 

53m 

4. 

5m 

0 

53m 

4, 

.5m 

0 

53m 

0 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

5m 

0 

52m 

4. 

.5m 

0 

52m 

0 

0 

52m 

5 

,  0m 

0 

52m 

5  . 

.  0m 

0 

52m 

5  . 

0m 

0 

52m 

5  . 

.  0m 

0 

52m 

0 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

.  5m 

0 

52m 

4. 

5m 

0 

52m 

4, 

.5m 

0 

52m 

0 

0 

52m 

4. 

.  6m 

0 

52m 

4. 

.  6m 

0 

52m 

4. 

6m 

0 

52m 

4. 

.  6m 

0 

52m 

0 

To  display  EE  monitors  on  a  port: 


switch : admin>  per f showeemonitor  4/5 

There  are  7  end-to-end 

monitor (s)  defined 

on  port  53 . 

KEY           SID  DID 

OWNER_APP 

OWNER_IP_ADDR 

TX_COUNT 

RX_COUNT 

CRC_COUNT 

0       0x21300  0x21dda 

TELNET 

N/A 

0x00000004d0ba9915 

0x0000000067229e65 

0x0000000000000000 

1       0x213  00  0x21ddc 

TELNET 

N/A 

0x00000004d0baa754 

0x0000000067229e65 

0x0000000000000000 

2       0x21300  0x21de0 

TELNET 

N/A 

0x00000004d0bab3a5 

0x0000000067229e87 

0x0000000000000000 

3       0x21300  0x21del 

TELNET 

N/A 

0x00000004d0bacle4 

0x0000000067229e87 

0x0000000000000000 

4       0x21300  0x21de2 

TELNET 

N/A 

0x00000004d0bad086 

0x0000000067229e87 

0x0000000000000000 

5       0x11000  0x21fd6 

WEB_TOOLS 

192.168.169. 

40 

0x00000004d0bade54 

0x0000000067229e87 

0x0000000000000000 

6       0x11000  0x21fe0 

WEB_TOOLS 

192.168.169. 

40 

0x00000004d0baed41 

0x0000000067229e98 

0x0000000000000000 

See  also 

perf AddEEMoni tor 
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perfShowFilterMonitor 


Displays  filter-based  performance  monitor  information  for  a  port. 

Synopsis 

perf showf iltermonitor  [slotnumber/] portnumber  [interval] 

Availability 

all  users 


p^f  NOTE:    This  command  requires  a  Performance  Monitor  license. 
This  command  is  deprecated;  use  perfMonitorShow  instead. 


Description 

Use  this  command  to  display  all  the  filter-based  monitors  defined  on  the  specified  port  and  the  traffic 
count  values. 

See  perfMonitorShow  for  details  regarding  this  command's  output. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number 

of  the  port  on  which  the  monitor  is  to  be  added,  followed  by  a 
slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchShow 
for  a  list  of  valid  ports. 

interval  Specify  an  interval,  in  seconds  (5  or  more).  This  operand  is 

optional. 

Optionally,  a  comma  can  separate  the  operands.  A  space  is  required  to  separate  the  operands  even 
when  using  commas. 

Examples 

To  display  filter  monitor  traffic  on  a  port  at  an  interval  of  every  6  seconds: 


switch 

admin>  perf showf iltermonitor 

2/5  6 

perf showf iltermonitor  21, 

6 

0 

1  2 

3 

4 

5 

6 

iFrames       #CMDs  #CMDs 

♦Frames 

#Frames 

#CMDs 

#CMDs 

0 

0  0 

0 

0 

0 

0 

26k 

187  681 

682 

682 

494 

187 

26k 

177  711 

710 

710 

534 

176 

26k 

184  734 

734 

734 

550 

184 

26k 

182  649 

649 

649 

467 

182 

26k 

188  754 

755 

755 

567 

184 

26k 

183  716 

716 

717 

534 

183 

26k 

167  657 

656 

655 

488 

167 

26k 

179  749 

749 

749 

570 

179 

(continued  on  next  page) 
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26k 

164 

752 

752 

752 

588 

164 

26k 

190 

700 

700 

700 

510 

190 

26k 

181 

701 

701 

701 

520 

181 

26k 

200 

750 

750 

751 

550 

201 

26k 

180 

692 

692 

691 

512 

179 

26k 

179 

696 

696 

696 

517 

179 

26k 

187 

720 

720 

720 

533 

187 

26k 

200 

722 

722 

722 

522 

200 

26k 

204 

717 

717 

717 

513 

204 

To  display  filter  monitor  information  on  a  port: 


switch : admin>  perf showf iltermonitor  2/5 

There  are  7  filter-based  monitors  defined  on  port  21. 


KEY 

ALIAS 

OWNER_APP 

OWNER 

_IP_ADDR 

FRAME_COUNT 

0 

SCSI_Frame 

TELNET 

N/A 

0x00000000002c2229 

1 

SCSI  WR 

TELNET 

N/A 

0x000000000000464a 

2 

SCSI_RW 

TELNET 

N/A 

0x000000000000fd8c 

3 

SCSI  RW 

WEB_TOOLS 

192 

.168.169 

.40 

0x0000000000007ba3 

4 

SCSI_RW 

WEB_TOOLS 

192  . 

168.169. 

190 

0x0000000000004f Oe 

5 

SCSI  RD 

WEB_TOOLS 

192 

.168.169 

.40 

0x0000000000002208 

6 

SCSI  WR 

WEB_TOOLS 

192 

.168.169 

.40 

0x000000000000033a 

NOTE:  If  you  do  not  specify  an  interval,  the  filter-based  monitor  frame  count  is  displayed  in  64-bit  format 
and  is  cumulative. 


See  also 

perf AddEEMoni tor 
perf AddlPMoni tor 
perf AddReadMoni tor 
perf AddRWMoni tor 
perf AddSCSIMoni tor 
perf AddUserMoni tor 
perf AddWriteMonitor 
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perf  ShowPortE  EMask 

Displays  the  current  address  mask  for  end-to-end  performance  monitors  on  a  port. 

Synopsis 

perf showporteeraask  [ slotnumber/] portnumber 

Availability 

all  users 


NOTE:   This  command  requires  a  Performance  Monitor  license. 


Description 

Use  this  command  to  display  the  current  mask  shared  across  all  end-to-end  (EE)  performance  monitors  of 
a  port.  There  are  only  two  commands  that  can  modify  the  value  of  the  EE  mask:  perf  SetPortEEMask 

and  perf Cf gRestore. 

The  end-to-end  mask  has  1 2  fields: 


TxSID  Domain: 

on 

TxSID  Area: 

on 

TxSID  ALPA: 

on 

TxDID  Domain: 

on 

TxDID  Area: 

on 

TxDID  ALPA: 

on 

RxSID  Domain: 

on 

RxSID  Area: 

on 

RxSID  ALPA: 

on 

RxDID  Domain: 

on 

RxDID  Area: 

on 

RxDID  ALPA: 

on 

The  fields  that  are  marked  on  are  used  to  trigger  end-to-end  monitors.  The  default  value  of  the  EE  mask  is 
all  fields  set  to  on. 

Operands 

This  command  has  the  following  operand: 

slotnumber  For  bladed  systems  only,  this  operand  specifies  the  slot  number  of  the 

port  on  which  the  monitor  is  to  be  added,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  the  port  on  which  the  monitor  is  to  be 

added,  relative  to  its  slot  for  bladed  systems.  Use  switchshow  for  a 
list  of  valid  ports. 
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Examples 

To  display  the  end-to-end  mask  on  a  port: 

switch : admin>  perf showporteemask  2/4 

The  EE  mask  onport  2  0  is  set  by  application  NONE 


TxSID 

Domain : 

on 

TxSID 

Area : 

on 

TxSID 

ALPA: 

on 

TxDID 

Domain : 

on 

TxDID 

Area : 

on 

TxDID 

ALPA: 

on 

RxSID 

Domain : 

on 

RxSID 

Area : 

on 

RxSID 

ALPA: 

on 

RxDID 

Domain : 

on 

RxDID 

Area : 

on 

RxDID 

ALPA: 

on 

See  also 

perf AddEEMoni tor 
perf DelEEMoni tor 
perf SetPortEEMask 
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pkiCreate 

Creates  public  key  infrastructure  (PKI)  objects. 

Synopsis 


pkicreate 

Availability 

admin 

Description 

Use  this  command  in  nonsecure  mode  to  create  PKI  objects: 

•  Switch  private  key  and  CSR 

•  Private  key  pass-phrase 
Install  root  certificate 

This  command  does  not  create  the  switch  certificate.  The  switch  certificate  should  be  obtained  offline  from 
Certificate  Authority. 

In  secure  mode,  this  command  exits  with  a  warning  and  does  not  create  PKI  objects. 

Operands 

none 

Examples 

To  create  PKI  objects  in  nonsecure  mode: 

switch : admin>  pkicreate 
Installing  Private  Key  and  Csr... 
Switch  key  pair  and  CSR  generated. . . 
Installing  Root  Certificate... 

If  run  in  secure  mode,  the  following  error  message  is  displayed: 

switch: admin>  pkicreate 

Warning  !!   Switch  is  in  secure  mode. 
Cannot  create  new  Pki  Objects.  Exiting... 

See  also 

pkiRemove 
pkiShow 
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pkiRemove 

Remove  existing  public  key  infrastructure  (PKI)  objects. 

Synopsis 

pkiremove 

Availability 

admin 

Description 

Use  this  command  to  remove  PKI  objects  in  nonsecure  mode.  It  removes  switch  private  key,  private  key 
pass-phrase,  CSR,  root  certificate,  and  switch  certificate. 

In  secure  mode,  this  command  displays  a  message  and  does  not  remove  PKI  objects. 

Operands 

none 

Examples 

To  remove  PKI  objects  in  nonsecure  mode: 

switch : admin>  pkiremove 

WARNING! ! ! 

Removing  Pki  objects  will  impair  the  security  functionality 
of  this  fibre  channel  switch.   If  you  want  secure  mode  enabled, 
you  will  need  to  get  the  switch  certificate  again. 

About  to  remove  Pki  objects. 

ARE  YOU  SURE   (yes,   y,   no,   n) :    [no]  y 

All  PKI  objects  removed. 

If  run  in  secure  mode,  the  following  error  message  is  displayed: 

switch : admin>  pkiremove 

This  Switch  is  in  secure  mode. 

Removing  Pki  objects  is  not  allowed.  Exiting... 

See  also 

pkiCreate 
pkiShow 
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pkiShow 


Displays  existing  public  key  infrastructure  (PKI)  objects. 


Synopsis 

pkishow 

Availability 

all  users 

Description 

Use  this  command  to  display  existence  of  PKI  objects,  such  as  switch  private  key,  private  key  pass-phrase, 
CSR,  root  certificate,  and  switch  certificate. 

Operands 

none 

Examples 

To  view  PKI  objects: 


switch : admin>  pkishow 


Passphrase 


Exist 


Private  Key 


Exist 


CSR 


Exist 


Certificate 


Empty 


Root  Certificate 


Exist 


See  also 


pkiCreate 


pkiRemove 
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portAlpaShow 

Displays  the  arbitrated  loop  physical  addresses  (AL_PAs)  of  devices  attached  to  a  port. 

Synopsis 

portalpashow  [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  device  ALPAs  present  in  a  port  and  whether  these  devices  are  public  or 
private.  If  the  port  is  not  an  active  FL  Port  or  if  it  does  not  have  any  ALPA,  this  command  displays  an 
error. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 

followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed  systems. 


Use  switchShow  to 

list  valid  ports. 

To  display  the 

AL  PAs  of  a  port: 

switch: 

user>  portalpashow  4/14 

AL_PA 

type  AL_PA 

type 

AL_PA  type 

0xe2 

public  0xe4 

public 

See  also 

switchShow 
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portBufferShow 


Displays  the  buffer  usage  information  for  a  port  group  or  for  all  port  groups  in  the  switch. 


Synopsis 


portbuf f ershow  [slotnumber/]  [portnumber] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  current  long-distance  buffer  information  for  the  ports  in  a  port  group.  The 
port  group  can  be  specified  by  giving  any  port  number  in  that  group.  If  no  port  is  specified,  then  the 
long-distance  buffer  information  for  all  of  the  port  groups  of  the  switch  is  displayed. 

The  following  long-distance  information  is  displayed: 


User  Port 
Port  Type 

Lx  Mode 


Max/Resv  Buffers 


Buffer  Usage 


Needed  Buffers 


Link  Distance 


Remaining  Buffers 


Displays  the  area  number  of  the  port. 

Displays  as  E  (E_Port),  F  (F_Port),  G  (G_Port),  L  (L_Port),  or  U 
(U_Port)  depending  on  the  port  type. 

Displays  as  LO  when  the  link  is  not  in  long  distance  mode,  LE 
when  the  link  is  up  to  10  km,  LM  when  the  link  is  up  to  25  Km, 
LI  when  the  link  is  up  to  50  km,  L2  when  the  link  is  up  to  100 
km  or  LD  when  the  distance  is  to  be  determined  dynamically. 

Displays  the  count  of  the  maximum  or  reserved  number  of  buffers 
that  are  allocated  to  the  port  based  on  the  estimated  distance 
(configured  by  the  desired_di stance  operand  of  the 
portCf  gLongDistance  command).  If  the  port  is  not 
configured  in  long  distance  mode,  certain  systems  might  reserve 
buffers  for  the  port.  This  field  then  displays  the  number  of  buffers 
reserved  for  the  port. 

Displays  the  actual  number  of  buffers  allocate  to  the  port.  In  LD 
mode,  the  number  is  determined  by  by  the  actual  distance  and 
the  user-specified  desired  distance  (configured  by  the 

desired_distance  operand  of  the 

portCf  gLongDistance  command). 

Displays  the  number  of  buffers  that  are  needed  to  utilize  the  port 
at  full  bandwidth  (depending  on  the  port  configuration).  If  the 
number  of  Buffer  Usage  is  less  than  the  number  of  Needed 
Buffers,  the  port  is  operating  in  the  buffer  limited  mode. 

For  LO  (not  in  long  distance  mode),  the  fixed  distance  displays 
based  on  the  port  speed,  for  instance:  1G  as  10  Km,  2G  as  5 
Km,  and  4G  as  2  Km.  For  the  static  long  distance  modes,  the 
fixed  distance  displays;  for  instance,  LE  as  10  Km,  LM  as  25  Km, 
LI  as  50  Km,  and  L2  as  100  Km.  For  LD  mode,  the  physical 
distance  in  kilometers  displays  as  measured  by  timing  the  return 
trip  of  a  MARK  primitive  that  is  sent  and  then  echoed  back  to  the 
switch.  The  supported  distance  measurement  is  up  to  500  Km. 
Distance  measurement  on  a  link  longer  than  500  Km  might  not 
be  accurate. 

Displays  the  remaining  (unallocated  and  reserved)  buffers  in  a 
port  group. 
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When  there  is  no  connection  to  a  port  or  the  port  is  disabled,  or  the  port  is  not  an  E_Port  some  of  the 
information  in  this  display  is  not  relevant,  such  as  long  distance  mode,  needed  buffers,  and  link  distance. 
In  this  case,  the  irrelevant  fields  display  as  hyphens. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  group  to 

display,  followed  by  a  slash  (/). 

portnumber  Specifies  the  number  of  a  port  associated  with  the  port  group  to  display, 

relative  to  its  slot  for  bladed  systems.  Use  switchShow  for  a  list  of  valid 
ports.  This  operand  is  optional;  if  omitted,  this  command  displays  the 
long  distance  buffer  information  for  all  the  port  groups  of  the  switch.  In 
the  case  where  this  command  displays  information  for  all  the  port  groups 
of  the  switch,  a  divider  line  displays  between  the  ports  of  each  port 
group  to  assist  in  readability. 

Examples 

To  display  the  long  distance  information  a  port: 

switch :user>  portbuf f ershow  17 


User     Port       Lx      Max/Resv  Buffer  Needed  Link  Remaining 

Port    Type    Mode    Buffers    Usage    Buffers    Distance  Buffers 


16  0 

17  E        LI  -  54  54  50km 

18  0 

19  -  -  0  -  -  54 


See  also 

portCfgLongDistan.ee 
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portCamShow 

Displays  port-based  filter  CAM  utilization. 

Synopsis 

portcamshow  [ slotnumber/]  [portnumber] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  filter  CAM  utilization  of  all  ports  or  one  port  specified  at  input. 
The  following  information  is  displayed: 


SID  free 
DID  free 


SID  used 


SID  entries 


DID  used 


DID  entries 


Total  number  of  CAM  entries  used  by  this  port.  Note  that  each  CAM 
entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in  the  same 
quad. 

Total  number  of  CAM  entries  used  by  this  port.  Note  that  each  CAM 
entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in  the  same 
quad. 

All  existing  source  ID  entries  within  the  CAM  per  quad.  Note  that  each 
CAM  entry  (either  SID  or  DID  CAM)  can  be  shared  among  ports  in  the 
same  quad. 

All  existing  destination  ID  entries  within  the  CAM  per  quad.  Note  that 
each  CAM  entry  (either  SID  or  DID  CAM)  can  be  among  ports  in  the 
same  quad. 

Total  number  of  free  SID  CAM  entries  per  quad. 
Total  number  of  free  DID  CAM  entries  per  quad. 


Operands 


This  command  has  the  following  operands: 


portnumber 


slotnumber 


For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 
followed  by  a  slash  (/). 

Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  list  valid  ports.  This  operand  is  optional; 
if  omitted,  information  for  all  ports  is  displayed. 
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Examples 

To  display  the  filter  CAM  utilization  for  all  ports  on  a  switch: 

switch :user>  portcamshow 


Ports  of  Slot  9 


Port 

SID  used 

DID 

used  SID 

free 

0 

0 

0 

64 

512 

1 

0 

0 

64 

512 

2 

0 

0 

64 

512 

3 

0 

0 

64 

512 

4 

0 

0 

64 

512 

5 

0 

0 

64 

512 

6 

0 

0 

64 

512 

7 

0 

0 

64 

512 

8 

0 

0 

63 

511 

9 

0 

0 

63 

511 

10 

0 

0 

63 

511 

11 

1 

1 

63 

511 

12 

0 

0 

46 

510 

13 

0 

0 

46 

510 

14 

0 

0 

46 

510 

15 

18 

2 

46 

510 

DID  free 


(output  truncated) 


To  display  the  filter  CAM  utilization  for  a  single  port  on  a  switch: 


switch :user>  portcamshow 

3/2 

Area    SID  used    DID  used 

SID  entries 

DID  entries 

34           3  1 

350400 

2b2200 

2bl200 

220400 

SID  Free,   DID  Free:  (61, 

511) 

See  also 

switchShow 
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portCfg 

Sets  a  port's  configuration  to  be  disabled  or  enabled. 

Synopsis 

portCfg  action  [slotnumber/]portnumber  [range]  mode 

Availability 

admin 

Description 

Use  this  command  to  disable  or  enable  configuration  to  a  certain  port  or  to  a  range  of  ports. 

Operands 

This  command  has  the  following  operands: 

action  Possible  action  includes  rscnsupr.  rscnsupr  is  for  the  local  port's 

RSCN  suppression.  When  RSCN  suppression  is  enabled  to  a  port, 
any  device  change  on  this  port  does  not  generate  RSCN  to  any  other 
end  device.  When  RSCN  suppression  is  disabled,  device  change  on 
this  port  generates  RSCN  to  another  end  device  that  is  zoned  with  this 
one.  By  default,  RSCN  suppression  is  disabled  to  all  the  ports. 

slotnumber         For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 
configured,  followed  by  a  slash  (/). 

portnumber         Specify  the  number  of  the  ports  to  be  configured,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  for  a  list  of  valid  ports. 

range  Specify  a  range  of  port  in  the  same  slot  to  apply  the  configuration.  The 

range  of  ports  has  to  be  equal  to  or  greater  than  the  portnumber. 

mode  Specify  --enable  to  enable  the  configuration.  Specify  --disable 

to  disable  the  configuration. 
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Examples 

To  configure  a  port  as  RSCN  suppressed: 


qtbtt  1~r"*Vi  •  ^ir]mi  t\  ~~>    nnvh  nf  n    Tern  cnrif*    ^  /  A  ati  aKl  o 

switch :admin>  portcfgshow 

[output  from  other  slots  suppressed] 

Ports  of  Slot  2 

0123  4567 

8  9 

10  11 

12 

13 

14 

15 

-  +  --+- -  +  --H  h  +  --  +  --  +  --  + 

 +  - 

+  --H  + 



H  

+  -- 

H  

Speed 

AN  AN  AN  AN  ANANANAN 

AN  AN 

AN  AN 

AN 

AN 

AN 

AN 

Trunk  Port 

ON  ON  ON  ON       ON  ON  ON  ON 

ON  ON 

ON  ON 

ON 

ON 

ON 

ON 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

Locked  G_Port 

Disabled  E_Port 

CreditShare 

ISL  R_RDY  Mode 

RSCN  Suppressed 

  ON  

Persistent  Disable    

where  AN:AutoNegotiate,    . . 

:0FF,    ??: INVALID. 

LM : L  0 . 5 
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To  configure  a  port  as  not  RSCN  suppressed: 


switch: admin>  portcfg  rscnsupr  2/4  --disable 

switch : admin>  portcfgshow 

[output  from  other  slots  suppressed] 

Ports  ot  Slot  2 

A           -1            '"1*1  /lCT/~r7 

U     1     2     J          4      b      b  / 

8  9 

10  11 

12 

13 

14 

15 

-H  1  1  1  1  1  1  1  h- 

 +  — 

^  + 



H  

+  -- 

+  -- 

Speed 

7\  T\T       7\  T\T       7V  "NT       7\  T\T                 7\  "NT       7\  "NT      7\  T\T       7\  T\T 

AN  AN  AN  AN       AN  AN  AN  AN 

AN  AN 

AN  AN 

AN 

AN 

AN 

AN 

Trunk  Port 

ON  ON  ON  ON       ON  ON  ON  ON 

ON  ON 

ON  ON 

ON 

ON 

ON 

ON 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

Locked  G_Port 

Disabled  E_Port 

CreditShare 

ISL  R_RDY  Mode 

RSCN  Suppressed 

Persistent  Disable    

where  AN : AutoNegotiate ,    . . : 

:OFF,    ??:  INVALID. 

LM:L0 . 5 
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To  configure  a  range  of  ports  as  RSCN  suppressed: 


switch :admin>  portcfg  rscnsupr  2/4-7  --enable 

switch : admin>  portcfgshow 

[output  from  other  slots  suppressed] 

Ports  of  Slot  2 

(J     1     Z     J          4     b      o  / 

8  9 

10  11 

12 

13 

14 

15 

-H  f  1  1  1  1  1  1  h- 

-+- 

+--+--+ 



H  

+  -- 

+  -- 

Speed 

7V  TvT       7\  "NT       7\  "NT       7\  "NT                 7\  T\T       7\  T\T       7\  T\T       7\  T\T 

AN  AN  AN  AN       AN  AN  AN  AN 

AN  AN 

AN  AN 

AN 

AN 

AN 

AN 

Trunk  Port 

ON  ON  ON  ON       ON  ON  ON  ON 

ON  ON 

ON  ON 

ON 

ON 

ON 

ON 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

Locked  G_Port 

Disabled  E_Port 

CreditShare 

ISL  R_RDY  Mode 

RSCN  Suppressed 

  ON  ON  ON  ON 

Persistent  Disable    

where  ANrAutoNegotiate,    . . : 

OFF,    ??: INVALID. 

LM : L  0 . 5 

See  also 

configure 

portShow 

switchShow 
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portCfgDefault 

Restores  the  port  configuration  to  default  values. 

Synopsis 

portcf gdef ault  [ slotnumber/] portnumber 

Availability 

admin 

Description 

Use  this  command  to  reset  any  special  configuration  values  on  a  port  to  their  factory  defaults.  You  can 
view  the  current  port  configuration  using  the  portcf  gShow  command. 

Operands 

This  command  has  the  following  operands: 

slotnumber         For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 
followed  by  a  slash  (/). 

portnumber         Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 
systems.  Use  switchShowto  list  valid  ports. 

Examples 

To  reset  a  port  to  factory  defaults: 

switch : admin>  portcf gdef ault  1/3 

See  also 

portCfgEPort 
portCfgGPort 
portCf gLongDi stance 
portCf gLPort 

portCf gPers is tentDi sable 
portCf gPers is tentEnable 
portCf gShow 
portCf gSpeed 
portCf gTrunkPort 
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portCfgEPort 


Enables  a  port  to  become  an  EPort  or  prevents  a  port  from  becoming  an  EPort. 


Synopsis 

portcfgeport    [ slotnumber/] portnumber,  mode 

Availability 

admin 

Description 


Use  this  command  to  enable  a  port  to  become  an  E_Port  or  to  prevent  a  port  from  becoming  an  E  Port. 
The  E_Port  capability  is  enabled  by  default  unless  this  command  is  used  to  disable  it. 

When  a  port  is  configured  as  a  non-E_Port  through  this  command,  an  ISL  connected  to  this  port  is 
segmented.  No  data  traffic  between  two  switches  is  routed  through  this  port.  Fabric  management  data, 
such  as  zoning  information,  are  not  exchanged  through  this  port  either. 

Regardless  of  how  many  E  Ports  are  connected  between  two  switches,  the  maximum  routing  paths  are 
currently  limited  to  16  E_Ports. 

Changes  made  by  this  command  are  persistent  across  switch  reboots  or  power  cycles. 


Operands 


This  command  has  the  following  operands: 


portnumber 


mode 


slotnumber 


For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to  be 
configured,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  to  be  configured,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

Specify  1  to  enable  the  port  to  become  an  E_Port.  This  is  the  default  port 
state.  Specify  0  to  disable  the  port  from  becoming  an  E  Port. 


Examples 


To  disable  a  port  from  becoming  an  E  Port: 


switch : admin>  portcfgeport  2/3,  0 


To  enable  a  port  to  become  an  E  Port: 


switch :admin>  portcfgeport  1/3,  1 


See  also 


portShow 


switchShow 
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portCfgGPort 

Designates  a  port  as  a  G_Port. 

Synopsis 

portcfggport  [slotnumber/] portnumber,  mode 

Availability 

admin 

Description 

Use  this  command  to  designate  a  port  as  a  G_Port.  After  this  is  done,  the  switch  attempts  to  initialize  that 
port  as  an  F  Port  only,  and  does  not  attempt  loop  initialization  (FL  Port)  on  the  port.  A  port  designated  as 
a  G_Port  can  become  an  EPort. 

Changes  made  by  this  command  are  persistent  across  switch  reboots  or  power  cycles. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 

configured,  followed  by  a  slash  (/). 

portnumber  Specify  the  number  of  the  port  to  be  configured,  relative  to  its 

slot  for  bladed  systems.  Use  switchShow  to  display  a  list  of 
valid  ports. 

mode  Specify  a  value  of  1  to  designate  the  port  as  a  G_Port  or  specify 

a  value  of  0  to  remove  the  G_Port  designation  from  the  port.  A 
value  of  0  is  the  default  port  state.  This  operand  is  required. 

Examples 

To  configure  a  port  as  a  locked  G_Port: 

switch: admin>  portcfggport  1/3,  1 

See  also 

configure 
portCfgLPort 
portShow 
switchShow 
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portCfglSLMode 

Enables  or  disables  ISL  RRDY  mode  on  a  port. 

Synopsis 

portcf gislmode  [slotnumber/]portnumber,  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  ISL  R  RDY  mode  on  a  port.  If  enabling  ISL  R  RDY  mode  on  a  port, 
make  sure  the  PID  format  is  consistent  across  the  entire  fabric.  See  the  configure  command  for  more 
information  on  the  core  PID  format. 

ISL  R  RDY  mode  sends  ELP  with  Flow  Control  Mode  02  and  enables  connectivity  with  WAN  gateway 
products.  If  a  port  is  ISL  R  RDY  mode-enabled,  it  can  only  receive  ELP  with  Flow  Control  Mode  02;  ELP 
with  Flow  Control  Mode  01  segments  the  fabric. 

This  mode  cannot  detect  the  PID  format  of  connected  ports.  If  the  PID  formats  for  two  ISL  R  RDY  mode 
ports  are  not  the  same,  zoning  drops  frames. 

This  feature  is  persistent  across  reboots  and  power  cycles. 

Use  the  portcf  gShow  command  to  view  whether  ISL  R_RDY  mode  is  enabled  on  a  port. 


NOTE:  The  portcf  glSLMode  and  portcf  gLongDistance  mode  both  cannot  be  enabled  at  the 
same  time;  otherwise,  fabric  segmentation  occurs. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 

followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed  systems. 

Use  switchShow  to  list  valid  ports. 

mode  Specify  1  to  enable  ISL  R_RDY  mode.  Specify  0  to  disable  ISL  R  RDY 

mode. 

Examples 

To  enable  ISL  R  RDY  mode  on  a  port: 

switch : admin>  portcf gislmode  1/3,  1 

ISL  R_RDY  Mode  is  enabled  for  port  3 .  Please  make  sure  the  PID 
formats  are  consistent  across  the  entire  fabric. 

To  disable  ISL  R  RDY  mode  on  a  port: 

switch : admin>  portcf gislmode  1/3,  0 
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See  also 

portCf gShow 
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portCfg  Long  Distance 


Configures  a  port  to  support  long-distance  links. 

Synopsis 

portcf  glongdistance  [  slotnumber/]  portnumber  [  distance_le\rel] 
[ vc_translation_link_init]    [ desired_di stance] 

Availability 

admin 


NOTE:    This  command  requires  an  HP  Extended  Fabrics  license. 


Description 

Use  this  command  to  allocate  enough  full-size  frame  buffers  on  a  particular  port  to  support  a 
long-distance  link  up  to  500  km.  The  port  can  only  be  used  as  an  F/FL/E_Port.  F/FL_Ports  can  be 
configured  only  for  long  distance  using  LE,  L0.5,  LI,  or  L2  modes.  Changes  made  by  this  command  are 
persistent  across  switch  reboots  or  power  cycles. 

The  value  of  distance_level  can  be  one  of  the  following  (the  numerical  value  representing  each 
distance_level  is  shown  in  parentheses): 

L0  (0)  Reconfigure  the  port  to  be  a  regular  switch  port.  A  total  of  20  full-size  frame 

buffers  are  reserved  for  data  traffic,  regardless  of  the  port's  operating  speed. 

L0.5  Level  0.5  (portcf  gShow  displays  the  two-letter  code  as  LM)  long  distance,  up  to 

25  km. 

LI  (1)  Level  1  long  distance,  up  to  50  km. 

L2  (2)  Level  2  long  distance,  up  to  1 00  km.  For  previously  released  switches 

(Bloom  1 -based),  the  number  of  frames  buffers  is  limited  to  63. 

LE  (3)  Level  E  mode  is  for  E  Ports  for  distances  beyond  5  km  and  up  to  10  km.  LE  does 

not  require  an  Extended  Fabrics  license. 

LD  Automatic  long-distance  configuration.  The  buffer  credits  for  the  given  E  Port  are 

automatically  configured,  based  on  the  actual  link  distance.  Up  to  a  total  of  250 
full-size  frame  buffers  are  reserved,  depending  upon  the  distance  measured 
during  E_Port  initialization.  If  the  desired  distance  is  provided,  it  is  used  as  the 
upper  limit  to  the  measured  distance.  For  Bloom  1 -based  systems,  the  number  of 
frame  buffers  is  limited  to  63. 

You  can  also  configure  a  long-distance  link  as  part  of  a  trunk  group  (see 
portcf  gTrunkPort).  Two  or  more  long-distance  links  in  a  port  group  forms  a 
trunk  group  when  they  are  configured  for  the  same  speed,  the  same  distance 
level,  and  their  link  distances  are  nearly  equal. 

For  details  about  buffer  allocation  at  specific  speeds  and  distances,  see  the  HP 
StorageWorks  Fabric  OS  5.x  command  reference  guide. 

The  vc_translation_link_init  option  is  used  to  enable  the  long-distance  link  initialization 
sequence. 

desired_di stance  is  a  required  parameter  to  configure  a  port  as  an  LD-mode  link.  The  desired 
distance  is  used  as  the  upper  limit  of  the  link  distance  to  calculate  buffer  availability  for  other  ports  in  the 
same  port  group.  When  the  measured  distance  is  more  than  desired_distance,  the 


Fabric  OS  5.x  command  reference  guide  453 


desired_distance  is  used  to  allocate  the  buffers.  In  this  case,  the  port  operates  in  degraded  mode 
instead  being  disabled  due  to  insufficient  buffers. 

Pressing  Ctrl+D  cancels  the  configuration  update. 

When  a  port  is  configured  to  be  a  long-distance  port,  the  output  of  portShow  and  switchShow 
displays  the  long-distance  level.  In  the  portShow  output,  the  long-distance  level  is  indicated  as  follows: 

•  LO  normal 

•  le  standard  <=  1 0  km 

•  LM  medium  long  <=  25  km 

•  Ll  long  <=  50  km 

•  L2  super  long  <=  1 00  km 

•  ld  auto 

In  the  switchShow  output,  the  long  distance  mode  appears  as  Lx,  where  x  is  the  second  letter  in  the 
two-letter  distance-level  code  described  earlier;  however,  L0.5  mode  displays  LM. 


NOTE:    The  portCf  glSLMode  and  portCf  gLongDi stance  mode  cannot  both  be  enabled  at  the 
same  time;  otherwise,  fabric  segmentation  occurs. 

If  a  port  is  configured  as  a  long-distance  port,  the  remaining  ports  of  that  port  group  could  be  disabled, 
fail  to  initialize,  or  move  to  "buffer  limited"  mode  due  to  a  lack  of  frame  buffers.  HP  StorageWorks  SAN 
Switch  2/8V,  2/1 6V,  and  2/32  switches  and  HP  StorageWorks  Core  Switch  2/64  and  2/128 
directors  do  not  support  "buffer  limited"  mode  and  can  have  up  to  four  ports  per  port  group.  The  4/8, 
4/16,  and  4/32  SAN  switches  and  the  4  GB  SAN  Switch  support  "buffer  limited"  mode  and  can  have 
up  to  eight  ports  per  port  group.  On  HP  StorageWorks  4/256  SAN  Director,  the  4/16  and  4/32  SAN 
switch  port  blades  support  "buffer  limited"  mode  and  can  have  up  to  four  ports  per  port  group. 


Operands 


This  command  has  the  following  operands: 


portnumber 


di  s tance_l evel 


slotnumber 


Specifies  the  slot  number,  for  bladed  systems  only.  The  slot 
number  must  be  followed  by  a  slash  (/). 

Specifies  a  port  number.  Valid  values  for  port  number  vary, 
depending  on  the  switch  type.  This  operand  is  required. 

See  the  Description  section  for  information  about  the  value. 


desired_di stance 


vc_ trans la tion_l ink_ini 


it     Specifies  the  long-distance  link-initialization  sequence;  1 

activates  and  0  deactivates  this  mode.  When  the  command 
is  run  without  specifying  a  value,  1  is  assigned 
automatically  for  the  long  distance  link.  This  operand  is 
optional. 

See  the  Description  section  for  information  about  the  value. 
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Examples 

To  configure  a  port  to  support  a  100  km  link  and  be  initialized  using  long-distance  link  initialization 
protocol: 

switch : admin>  portcfglongdistan.ee  4/15  L2  1 
switch : admin>  portshow  4/15 
portCFlags :  0x1 

portFlags:    0x20001  PRESENT  LED 

portType:  1.1 

portState:   2  Offline 

portPhys :     4  No_Light 

portScn:  0 

portld:  013f00 

portWwn:        20 : 3f : 00 : 60 : 69 : 00 : 02 : 48 
Distance:     super  long  <=  100km 
portSpeed:  2Gbps 


Interrupts : 
Unknown : 
Lli: 

Proc_rqrd : 
Timed_out : 
Rx_f lushed : 
Tx_unavail : 
Free_buf f er : 
Overrun : 
Suspended: 
Parity_err : 
2  parity  err : 
CMI_bus_err : 


Link_f ailure :  0 
Loss_of_sync :  0 


Frjt: 
Fbsy : 


Loss_of_sig : 
Protocol_err : 
Invalid_word : 
Invalid_crc : 
Delim_err : 
Address_err : 
Lr_in : 
Lr_out : 
01s_in: 
Ols  out: 


See  also 


configure 
portCf gShow 
portShow 
switchShow 
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portCfgLPort 

Locks  a  port  as  an  LPort. 

Synopsis 

portcfglport  [ slotnumber/] portnumber  locked_mode  [private_mode] 
[ dupl ex_mode ] 


Availability 

admin 


Description 

Use  this  command  to  designate  a  port  as  an  L_Port.  The  switch  then  only  attempts  to  initialize  that  port  as 
an  FL_Port.  By  default,  the  L  Port  is  a  public  L_Port.  It  can  be  set  to  private  L  Port  and  the  FLOGI  is 
rejected. 

The  switch  never  attempts  point-to-point  (F_Port)  initialization  on  the  port. 


Operands 


The  operands  are  as  follows: 


slotnumber 
portnumber 

1 ocked_mode 

pri va t e_mode 


dupl ex_mode 


For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 
be  configured,  followed  by  a  slash  (/). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports.  This  operand  is  optional;  if  omitted,  this  command 
displays  the  L_Port  conditions  for  all  ports. 

Specify  1  to  configure  the  specified  port  as  a  locked  L  Port. 
Specify  0  to  deconfigure  the  specified  port  from  its  previous  role 
as  a  locked  L_Port.  This  operand  is  required  if  portnumber  is 
specified. 

Specify  1  to  configure  the  L_Port  as  a  private  L  Port.  Specify  0 
to  configure  the  L  Port  as  a  normal  public  L  Port.  This  operand 
is  optional;  if  omitted;  the  default  value  of  0  is  used.  Private 
devices  are  supported  only  on  HP  StorageWorks  SAN  Switch 
2/8V,  2/ 16V,  2/32  switches  and  HP  StorageWorks  Core 
Switch  2/64,  and  HP  StorageWorks  SAN  Director  2/1  28  and 
4/256  directors  with  SAN  Switch  2/16  blades.  For  other 
switches  and  blade  types,  option  1  is  blocked. 

Specify  2  to  configure  the  specified  port  as  a  full-duplex  L  Port 
with  fairness.  Specify  1  to  configure  the  L_Port  as  a  half-duplex 
L  Port  with  fairness.  Specify  0  to  configure  the  L  Port  as  a 
full-duplex  L_Port.  This  operand  is  optional;  if  omitted,  the 
default  value  of  0  is  used. 


If  used  without  operands,  this  command  reports  the  L  Port  conditions  for  all  ports  present. 
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Examples 

To  configure  a  port  as  a  locked  LPort: 


switch : admin>  portcfglport  4/15,  1 

switch : admin>  portcfgshow 

[output  from  other  slots  suppressed] 

Ports  of  Slot  4 

0     1     2     3         4     5  6 

7 

8  9 

10  11  12 

13 

14 

15 

-H  1  1  1  h  H  1  

+  --  + 

+  -- 

+--+--+  

H  

+-- 

H  

Speed 

AN  AN  AN  AN       AN  AN  AN 

AN 

AN  AN 

AN  AN  AN 

AN 

AN 

AN 

Trunk  Port 

ON  ON  ON  ON       ON  ON  ON 

ON 

ON  ON 

ON  ON  ON 

ON 

ON 

ON 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

ON 

Locked  G_Port 

Disabled  E_Port 

ISL  R_RDY  Mode 

Persistent  Disable    

where  AN:AutoNegotiate 

:OFF,    ??: INVALID. 

To  display  the  L  Port  conditions: 


switch :admin>  portcfglport 

[output  from  other  slots  suppressed] 

Ports  of  Slot  4         0123  4567 

8     9  10  11 

12  13  14  15 

 1  1  1  1  H  1  1  1  +  - 

 h  +  h- 

 H  + 

Locked  L  Port     

 ON 

Private  L  Port     

Locked  Loop  HD     

Loop  Fairness     

See  also 

configure 
switchShow 
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portCfgPersistentDisable 

Disables  a  port  persistently. 

Synopsis 

portcf gpersistentdisable  [ slotnumber/] portnumber 

Availability 

admin 


Description 

Use  this  command  to  persistently  disable  a  port.  Persistently  disabled  ports  remain  disabled  across  power 
cycles,  switch  reboots,  and  switch  enables.  By  default,  a  port  is  enabled  persistently.  The  change  in 
configuration  is  effective  immediately. 

The  persistent  disable  configuration  overrides  all  other  port  configurations  but  it  does  not  change  the 
configuration  of  any  other  port  settings.  Use  the  portcf  gPersistentEnable  command  to  enable  a 
port  persistently.  A  persistent-enabled  port  reenables  all  previously  set  port  configurations  of  that  port. 

The  switch  still  runs  power-on  diagnostics  and  initializes  a  persistently  disabled  port.  The  portEnable 
command  fails  when  directed  to  a  persistently  disabled  port.  The  switchEnable  command  does  not 
enable  the  persistently  disabled  ports  of  that  switch,  and  the  bladeEnable  command  does  not  enable 
the  persistently  disabled  ports  of  that  blade.. 

The  persistent  switch  disable  or  enable  configuration  does  not  alter  the  persistent  disable  or  enable 
configurations  of  the  ports  within  the  switch. 

Because  the  default  state  of  the  port  is  persistently  enabled,  the  persistent  disable  state  is  cleared  by  the 

portcf gDefault  command. 

This  command  is  not  allowed  if  the  switch  is  operating  in  the  FICON  Management  Server  mode 
(fmsmode);  instead,  use  portDisable  with  Active=Saved  mode  enabled. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

configure,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  configure,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays  the 
persistently-disabled  condition  for  all  ports. 

Examples 

To  configure  a  port  as  persistently  disabled  and  then  display  all  ports  that  are  permanently  disabled: 

switch : admin>  portcf gpersistentdisable  9/3 
switch: admin>  portcf gpersistentdisable 

Slot  9  0       1       2       3       4       5       6       7       8       9     10     11     12     13     14  15 

Disabled      -  YES     -      --      --      --      --      --  - 

(output  truncated) 
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See  also 

f iconcupset 
f iconcupshow 
portCf gDef ault 
portDisable 
portEnable 

portCf gPersistentEnable 

portShow 

switchShow 
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portCfgPersistentEnable 


Enables  a  port  persistently. 

Synopsis 

portcf gpersistentenable  [ slotnumber/] portnumber 

Availability 

admin 

Description 

Use  this  command  to  persistently  enable  a  port.  Persistently  enabled  ports  remain  enabled  across  power 
cycles,  switch  reboots,  and  switch  enables.  By  default,  a  port  is  enabled  persistently.  The  change  in 
configuration  is  effective  immediately. 

A  persistent  port  enable  reenables  all  previously  set  port  configurations  of  that  port.  A  persistently 
enabled  port  can  temporarily  be  disabled  by  the  portDisable  or  switchDisable  command.  The 
switchDisable  command  will  also  disable  the  persistently  enabled  ports  of  that  switch. 

The  persistent  switch  disable  or  enable  configuration  does  not  alter  the  persistent  disable  or  enable 
configurations  of  the  ports  within  the  switch. 

The  configuration  commands  conf  igDef ault  and  portcf gDef  ault  do  not  modify  the  persistent 
enable  attribute  of  a  port. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

configure,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  configure,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays  the 
persistently  enabled  condition  for  all  ports. 

When  no  operand  is  specified,  the  command  reports  the  current  port  persistently  enabled  status  for  all 
ports  in  the  switch.  The  value  of  yes  is  displayed  for  ports  that  are  persistently  enabled. 

Examples 

To  configure  a  port  as  persistently  enabled  and  then  display  all  ports  that  are  persistently  enabled: 


switch: admin>  portcf gpersistentenable 

9/3 

switch: admin>  portcf gpersistentenable 

Slot  9  0123456 

7  8 
 +  

9     10     11     12     13     14  15 

Enabled       YES  YES  YES  YES  YES  YES  YES 

YES  YES 

YES  YES  YES  YES  YES  YES  YES 

(output  truncated) 
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See  also 

f iconcupset 
f iconcupshow 
f iconcupset 
f iconcupshow 
portDisable 
portDisable 
portEnable 

portCf gPersistentDisable 

portCf gShow 

portShow 

switchShow 
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portCfgShow 


Displays  port  configuration  settings. 


Synopsis 


portcfgshow  [ slotnumber/]  [portnumber] 


Availability 

all  users 

Description 

Use  this  command  to  display  the  current  configuration  of  all  ports.  If  no  operand  is  specified,  all  the  port 
configuration  settings  are  displayed  for  that  switch  or  for  the  Core  Switch  2/64  logical  switch. 

The  following  configuration  information  appears: 


Speed  mode 
Trunk  Port  mode 

Long  Distance  mode 


VC  Link  Init  mode 
(virtual  channel) 


Locked  L  Port  mode 


Locked  G  Port  mode 


Disabled  E  Port  mode 


Mcast  LoopBack  mode 


ISL  R  RDY  Mode  mode 


RSCN  Suppression 


Persistent  Disable  mode 


Displays  as  1G,  2G,  or  an  (when  in  auto  speed  negotiation 
mode).  This  value  is  set  by  the  portCf  gSpeed  command. 

Displays  as  ON  when  port  is  set  for  trunking  or  blank  (..)  when 
trunking  is  disabled  on  the  port.  This  value  is  set  by  the 

portCf gTrunkPort  command. 

Displays  as  blank  (..)  when  the  mode  is  off,  LI  when  the  link  is 
up  to  50  km,  or  L2  when  the  link  is  up  to  1 00  km,  and  also 
supports  LE,  L0.5,  and  LD  modes.  This  value  is  set  by  the 

portCf gLongDistance  command. 

Displays  as  blank  (..)  when  the  long-distance  link  initialization 
option  is  turned  off  and  (on)  when  it  is  turned  on  for  long 
distance  mode.  This  value  is  set  by  the 

portCf  gLongDistance  command. 

Displays  as  ON  when  port  is  locked  to  L_Port  only  or  blank  (..) 
when  L_Port  lock  mode  is  disabled  (and  it  behaves  as  a  U_Port). 
This  value  is  set  by  the  portCf  gLPort  command. 

Displays  as  ON  when  port  is  locked  to  G_Port  only  or  blank  (..) 
when  G_Port  lock  mode  is  disabled  (and  it  behaves  as  a 
U_Port).  This  value  is  set  by  the  portCfgGPort  command. 

Displays  as  ON  when  port  is  not  allowed  to  be  an  E_Port  or  blank 
(..)  when  the  port  is  allowed  to  function  as  an  E_Port.  This  value 

is  set  by  the  portCf  gEPort  command. 

Displays  as  blank  (..)  when  mcast  loopback  mode  is  off,  and 
(on)  when  mcast  loopback  mode  is  enabled.  This  value  is  set  by 

the  portCf  gMcastLoopback  command. 

Displays  as  ON  when  the  port  has  been  R_RDY-mode  enabled  or 
blank  (..)  when  the  port  is  allowed  to  function  as  an  E_Port.  This 
value  is  set  by  the  portCf  glSLMode  command. 

Displays  as  ON  when  the  port  has  RSCN  suppression  enabled  or 
blank  (..)  when  the  port  has  RSCN  suppression  disabled.  This 
value  is  set  by  the  portCfg  rscnsupr  command. 

Displays  as  ON  when  the  port  is  disabled  across  reboots  or 
power  cycles  or  blank  (..)  when  the  port  is  allowed  to  function 
normally.  This  value  is  set  by  the 

portCf gPer sis tentDi sable  command. 
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Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to 

display,  followed  by  a  slash  (/). 

portnumber  Specifies  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports.  This 
operand  is  optional;  if  omitted,  this  command  displays 
information  for  all  ports. 

Examples 

To  display  the  configuration  settings  of  a  switch: 


switch :user>  portcfgshow 

Ports  of  Slot  1 

0     12  3 

4 

5  6 

7 

8 

9 

10 

11 

12  13 

14 

15 

Speed 

-|  H--H  +  h- 

AN  AN  AN  AN 

a  "NT 
HIM 

-i  h-- 

HIM  HTM 

-I  

AIM 

HIM 

+  -- 

HIM 

H  

HIM 

+--+ 

HIM 

7\  "NT  "NT 
HIM 

+  -- 

ai\7 
HIM 

+  -- 

HIM 

Trunk  Port 

Long  Distance 

VC  Link  Init 

Locked  L_Port 

Locked  G_Port 

Disabled  E_Port 

ISL  R_RDY  Mode 

RSCN  Suppressed 

Persistent  Disable  

Ports  of  Slot  4 

0      12  3 

4 

5  6 

7 

8 

9 

10 

11 

12  13 

14 

15 

Speed 

H  +  h- 

AN  AN  AN  AN 

AN 

-1  K~ 

AN  AN 

-i  

AN 

AN 

+  -- 
AN 

-1  

AN 

+  --  + 

AN 

AN  AN 

+  -- 
AN 

H  

AN 

Trunk  Port 

Long  Distance 

.  .  L2 

LI 

L2 

L2 

VC  Link  Init 

.  .  ON 

ON 

ON 

ON 

Locked  L_Port 

Locked  G_Port 

Disabled  E_Port 

ISL  R_RDY  Mode 

RSCN  Suppressed 

ON 

Persistent  Disable  

where  AN 

AutoNegotiate 

:OFF, 

?  ?  : 

INVALID 
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To  display  the  configuration  settings  of  a  port: 


switch :user>  portcfgshow 

4/15 

Area  Number : 

63 

Speed  Level : 

AUTO 

Trunk  Port 

OFF 

Long  Distance 

OFF 

VC  Link  Init 

OFF 

Locked  L_Port 

OFF 

Locked  G_Port 

OFF 

Disabled  E_Port 

OFF 

ISL  R_RDY  Mode 

OFF 

RSCN  Suppressed 

OFF 

Persistent  Disable 

OFF 

See  also 

portCf g 
portCfgEPort 
portCfgGPort 
portCf gLongDi stance 
portCfgLPort 
portCf gSpeed 
portCf gTrunkPort 
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portCfgSpeed 


Configures  the  port  speed  level. 


Synopsis 


portcfgspeed  [ slotnumber/] portnumber  speed_level 


Availability 

admin 


Description 

Use  this  command  to  configure  the  speed  of  a  port  to  a  particular  level.  After  this  command  is  issued,  the 
port  is  disabled  and  enabled  so  that  the  port  comes  up  with  the  new  speed  setting.  The  configuration  is 
saved  in  the  flash  memory  and  is  persistent  across  switch  reboot  or  power  cycle. 

If  the  command  is  specified  without  an  operand,  you  are  prompted  to  enter  the  speed  value. 
Press  Ctrl+D  to  cancel  the  configuration  update. 

The  output  of  the  portShow  command  displays  the  current  achieved  speed  of  a  port  and  the 
portCf  gShow  command  displays  the  user-desired  speed  setting  for  a  port. 


Operands 


This  command  has  the  following  operands: 

slotnumber 


portnumber 
speed_level 


For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 
configured,  followed  by  a  slash  (/). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

Specify  the  speed  of  a  port.  This  operand  is  required.  Valid  values  are 
one  of  the  following: 

0  Autosensing  mode.  The  port  automatically  configures  for  the 
highest  speed. 

1  1  -Gb/ s  mode.  The  port  is  at  fixed  speed  of  1  Gb/ s. 

2  2-Gb/s  mode.  The  port  is  at  fixed  speed  of  2  Gb/s. 
4             4-Gb/ s  mode.  The  port  is  at  fixed  speed  of  4  Gb/ s. 


Examples 


To  configure  the  speed  of  a  port  to  2  Gb/s: 

switch: admin>  portcfgspeed  2/3,  2 


See  also 


portCf gShow 
portShow 
switchCf gSpeed 


466   Fabric  OS  commands 


portCfgTrunkPort 

Configures  a  port  to  be  enabled  or  disabled  for  HP  ISL  Trunking  license. 

Synopsis 

portcf gtrunkport  [ slotnumber/] portnumber  mode 

Availability 

admin 


NOTE:    This  command  requires  a  ISL  Trunking  license. 


Description 

Use  this  command  to  enable  or  disable  a  port  for  trunking. 


NOTE:    You  can  disable  or  enable  trunking  using  the  portCfgTrunkPort  or  switchCf gTrunk 
commands.  When  the  command  is  executed  to  update  the  trunking  configuration,  the  ports  for  which  the 
configuration  applies  are  disabled  and  reenabled  with  the  new  trunk  configuration.  As  a  result,  the  traffic 
through  these  ports  might  be  disrupted  for  a  period  of  time. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

be  configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

mode  Specify  1  to  enable  this  port  for  trunking.  Specify  0  to  disable 

this  port  for  trunking.  This  operand  is  required. 

Examples 

To  enable  a  port  for  trunking: 

switch :admin>  portcf gtrunkport  1/3  0 

See  also 

portCf gShow 
portShow 
switchCf gTrunk 
switchShow 
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portDebug 

Sets  debug  level  and  verbose  level  of  port  modules. 

Synopsis 

por tdebug  dbg_lvl,  vbs_lvl 

Availability 

admin 

Description 

Use  this  command  to  set  the  debug  level  and  verbose  level  of  port  modules. 

Operands 

This  command  has  the  following  operands: 

dbg_lvl  Specify  the  debug  level  to  be  set  for  port  modules;  valid  values  are  1  to  5. 

vbs_lvl  Specify  the  verbose  level  to  be  set  for  port  modules;  valid  values  are  1  to  5. 

Examples 

To  set  debug  level  and  verbose  level  of  port  modules: 

switch : admin>  por tdebug  3  4 


See  also 

dbgShow 
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portDisable 

Disables  a  port. 

Synopsis 

portdisable  [ slotnumber/] portnumber 

Availability 

admin 

Description 

Use  this  command  to  disable  a  port.  If  the  port  is  connected  to  another  switch,  the  fabric  might 
reconfigure.  If  the  port  is  connected  to  one  or  more  devices,  the  devices  can  no  longer  communicate  with 
the  fabric. 

If  the  port  was  online  before  being  disabled,  a  state  transition  will  be  indicated:  RSCN,  an  SNMP  trap,  a 
Web  pop-up  window. 

The  front-panel  LED  of  a  disabled  port  flashes  yellow  with  a  two-second  cycle. 

Operands 

This  command  has  the  following  operand: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

be  configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

Examples 

To  disable  a  port: 

switch : admin>  portdisable  2/4 

See  also 

portCf gPersistentDisable 

portCf gPersistentEnable 

portEnable 

portShow 

switchShow 
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port  Enable 

Enables  a  port. 

Synopsis 

portenable  [ slotnumber/] portnumber 

Availability 

admin 

Description 

Use  this  command  to  enable  a  port.  If  the  port  is  connected  to  another  switch,  the  fabric  might 
reconfigure.  If  the  port  is  connected  to  one  or  more  devices,  the  devices  can  communicate  with  the  fabric. 

For  ports  that  come  online  after  being  enabled,  the  following  indications  might  be  sent  to  indicate  a  state 
transition:  RSCN,  SNMP  trap,  Web  pop-up  window. 

This  command  is  rejected  if  the  port's  switch  is  disabled,  the  port's  blade  is  not  fully  enabled  (faulted, 
powered  off,  or  disabled),  or  if  the  port  itself  is  persistently  disabled. 

The  front  panel  LED  of  an  enabled  and  online  port  is  green. 

Operands 

This  command  has  the  following  operand: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

be  configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 

Examples 

To  enable  a  port: 

switch : admin>  portenable  2/4 

See  also 

portCf gPersistentDisable 

portCf gPersistentEnable 

portDisable 

portShow 

switchShow 
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portErrShow 

Displays  port  error  summary. 

Synopsis 

porterrshow 

Availability 

all  users 

Description 

Use  this  command  to  display  an  error  summary  for  all  ports.  The  display  contains  one  output  line  per  port 
and  shows  error  counters  in  ones,  thousands  (k),  or  millions  (m). 

The  following  fields  are  displayed: 


frames  tx  Frames  transmitted 

frames  rx  Frames  received 

enc  in  Encoding  errors  inside  frames 

crc  err  Frames  with  CRC  errors 

too  shrt  Frames  shorter  than  minimum 

too  long  Frames  longer  than  maximum 

bad  eof  Frames  with  bad  end-of-frame  delimiters 

enc  out  Encoding  error  outside  of  frames 

disc  c3  Class  3  frames  discarded 

link  fail  Link  failures  (LF1  or  LF2  states) 

loss  sync  Loss  of  synchronization 

loss  sig  Loss  of  signal 

frjt  Frames  rejected  with  F  RJT 

fbsy  Frames  busied  with  F  BSY 


Operands 

none 

Examples 

To  display  error  counters  for  ports  on  a  switch: 


switch :user>  porterrshow 

frames    enc    crc  too 

too 

bad 

enc  disc  link  loss  loss  frjt 

fbsy 

tx      rx       in     err  shrt 

long 

eof 

out 

c3  fail  sync  sig 

0:     154     152        0        0  0 

0 

0 

2  .  0m 

0        12        0  0 

0 

1:     154     152        0        0  0 

0 

0 

1 .  9m 

0        12        0  0 

0 

(Continued  on  next  page) 
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See  also 

portShow 
port Stats Show 
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portFlagsShow 

Displays  the  port  status  bitmaps  for  all  ports  in  a  switch. 

Synopsis 

port flags show 

Availability 

all  users 

Description 

Use  this  command  to  display  the  following  status  for  a  port: 

SNMP  Displays  whether  the  port  is  online  or  offline. 

Physical  Displays  the  port  physical  status.  Valid  values  are  In  Sync  and 

No_Light. 

Flags  Displays  whether  there  is  an  SFP  inserted  in  the  port,  whether  the 

port  is  active,  and  the  port  type. 

Operands 

none 

Examples 

To  display  the  port  status  for  all  ports  in  the  switch. 

switch :user>  portf lagsshow 
Slot         Port         SNMP  Physical  Flags 


1 

0 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

1 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

2 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

3 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

4 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

5 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

6 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G. 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

7 

Online 

In. 

_Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

8 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

9 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

10 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

11 

Offline 

No_ 

.Light 

PRESENT 

LED 

1 

12 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

13 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

14 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

1 

15 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

4 

0 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

4 

1 

Online 

In. 

.Sync 

PRESENT 

ACTIVE 

E_ 

.PORT 

G_ 

.PORT 

LOGIN 

LED 

ACCEPT 

(continued  on  next  page) 
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4 

2 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

3 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

4 

Offline 

No_Light 

PRESENT 

LED 

4 

5 

Offline 

No_Light 

PRESENT 

LED 

4 

6 

Online 

In_Sync 

PRESENT  ACTIVE  F_PORT  L_PORT  LOGIN  NOELP  LED  ACCEPT 

4 

7 

Online 

In_Sync 

PRESENT  ACTIVE  F_PORT  L_PORT  LOGIN  NOELP  LED  ACCEPT 

4 

8 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

9 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

10 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

11 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

12 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

13 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

14 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

4 

15 

Online 

In_Sync 

PRESENT 

ACTIVE 

E_PORT 

G_PORT 

LOGIN 

LED 

ACCEPT 

See  also 

portShow 


switchShow 
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portLedTest 

Cycles  user  port  LEDs. 

Synopsis 

portledtest   [-npass  count] [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  exercise  the  user  port  LEDs  in  the  current  switch  on  and  off  by  setting  the  ATTN  LEDs 
to  green  for  the  ON  condition  and  unlighted  for  the  OFF  condition.  The  SPEED  LEDs  are  initially  set  to 
black  before  the  command  execution.  The  SPEED  LEDs  are  set  to  green  once  the  command  is  executing. 

You  must  disable  the  current  switch  (using  the  switchDisable  command)  before  running  this 
command.  After  the  command  had  completed,  the  ATTN  LEDs  flash  amber,  indicating  that  the  command 
has  finished  and  exited.  You  can  enable  the  current  switch  (using  the  switchEnable  command)  to  set 
the  ATTN  LEDs  back  to  black. 

Operands 

This  command  has  the  following  optional  operands: 

-npass  count  Specify  the  number  of  times  to  perform  this  test.  The  default  value 

is  10. 

-ports  i  temlist         Specify  a  list  of  user  ports  to  run  the  test.  If  omitted,  all  the  active 

ports  in  the  switch  are  assumed.  For  more  information,  see  the 
itemList  command. 

Examples 

To  test  port  LEDs: 

switch :admin>  portledtest  -ports  1/1-1/5 
passed. 

See  also 

itemList 

switchDisable 

switchEnable 
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portLogClear 

Clears  the  port  log. 

Synopsis 

portlogclear 

Availability 

admin 

Description 

Use  this  command  to  clear  the  port  log.  You  might  want  to  clear  the  port  log  before  triggering  an  activity 
so  that  the  log  displays  only  the  log  events  related  to  that  activity. 

If  the  port  log  is  disabled,  the  following  message  appears  as  the  first  line. 

WARNING:  port  log  is  disabled 

If  the  port  log  is  disabled,  portLogClear  enables  it.  Certain  errors  automatically  disable  the  port  log  to 
preserve  information  needed  to  understand  the  error  (new  events  are  not  collected  so  that  existing 
information  is  not  overwritten). 

The  following  errors  disable  the  port  log: 

FCPH,  EXCHBAD 
FCPH,  EXCHFREE 
NBFSM,  DUPEPORTSCN 
UCAST,  RELICPDB 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

Operands 

none 

Examples 

To  clear  the  port  log: 

switch :admin>  portlogclear 
switch : admin>  portlogshow 
port  log  is  empty 

See  also 

portLogDump 
portLogShow 
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portLogConfigShow 

Displays  the  current  port  log  configuration. 

Synopsis 

portlogconf igshow 

Availability 

admin 

Description 

Use  this  command  to  display  the  current  port  log  configuration. 

Operands 

none 

Examples 

To  display  the  current  port  log  configuration: 

switch : admin>  portlogconf igshow 
max  portlog  entries  =  8192 

See  also 

portLogResize 
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portLogDump 

Displays  the  port  log  without  page  breaks. 

Synopsis 

portlogdump  [count [,   saved[,  portid]]] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  listing  all  entries  in  the  log  without  page  breaks.  This  command 
displays  the  same  information  as  portLogShow,  but  portLogShow  prompts  the  user  to  press  Enter 
between  each  page. 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  See  portLogClear  command 
for  more  information. 

WARNING:  port  log  is  disabled 

For  a  full  explanation  of  the  information  displayed  by  this  command,  see  the  HP  StorageWorks 
Fabric  OS  5.x  procedures  user  guide. 

Operands 

This  command  has  the  following  operands: 

count  Specify  the  maximum  number  of  lines  to  be  displayed.  Only  the  most 

recent  count  entries  are  displayed.  This  operand  is  optional. 

saved  Specify  a  nonzero  value  to  display  the  saved  port  log  from  the  last  switch 

fault.  See  upTime  for  conditions  that  cause  a  fault.  The  operand  count 
is  ignored  when  displaying  the  saved  log.  This  operand  is  optional. 

portid  Specify  the  port  to  display.  All  other  ports  will  not  be  displayed.  This 

operand  is  optional. 

Examples 

To  display  the  port  log  for  a  port: 


switch : user> 

portLogDump 

20 

time 

task 

event 

port 

cmd 

args 

08  :  35 

27 

899 

tShell 

pstate 

14 

OL1 

08  :  35 

27 

899 

tReceive 

pstate 

14 

LR2 

08  :  35 

27 

916 

tReceive 

pstate 

14 

AC 

08  :  35 

28 

416 

interrupt 

sen 

14 

1 

08:35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08  :  35 

28 

433 

tFabric 

Tx 

14 

164 

02 f f f f fd# 00f f f f fd, 0005f f f f , 10000000 

08  :  35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08  :  35 

28 

433 

tReceive 

Rx 

14 

164 

03fffffd, OOfffffd, 00050006,  02  000000 

08:35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00050006 

08:35 

28 

433 

tFabric 

ioctl 

14 

91 

103646d8, 0 

(continued 

on  next  page) 
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switch :user> 

portLogDump 

20 

time 

task 

event 

port 

cmd 

args 

08:35 

27 

899 

tShell 

pstate 

14 

OL1 

08:35 

27 

899 

tReceive 

pstate 

14 

LR2 

08  :  35 

27 

916 

tReceive 

pstate 

14 

AC 

08:35 

28 

416 

interrupt 

sen 

14 

1 

08  :  35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08:35 

28 

433 

tFabric 

Tx 

14 

164 

02 f f f f rd, 00f f f f fd, 0005f f f f , 10000000 

08  :  35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08  :  35 

28 

433 

i~  "P  d  f1  d  ~~\  T  T  f""* 

LacLcIVc 

Rx 

14 

164 

03fffffH  nnfffffH  0 0  0^,00 of,  n9nnnnnn 

UOlllllU,                               UUUOUUWD,  UZUUUUUU 

08  :  35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

See  also 

portLogClear 

portLogShow 

upTime 
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portLogDumpPort 

Displays  the  port  log  of  specified  port,  without  page  breaks. 

Synopsis 

portlogdumpport  portid 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log  of  specified  port.  The  command  displays  all  entries  in  the  log 
without  any  page  breaks.  It  is  identical  to  portLogShowPort,  except  that  portLogShowPort  prompts 
the  user  to  press  Enter  between  each  page. 

Port  logs  are  circular  log  files  in  the  switch  firmware,  which  can  save  up  to  8,192  entries.  See 
portLogConf  igShow  to  display  the  current  port  log  size.  Once  the  log  is  full,  the  newest  log  entries 
delete  the  oldest  log  entries.  Port  logs  capture  switch-to-device,  device-to-switch,  switch-to-switch,  some 
device-to-device  1 ,  and  control  information 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  See  portLogClear  command 
for  more  information. 

WARNING :  port  log  is  disabled 
See  the  HP  StorageWorks  Fabric  OS  5.x  procedures  user  guide  for  more  information. 

Operands 

This  command  has  the  following  operand: 

portid  Specify  the  area  number  of  port  to  display.  If  a  port  area  number  is 

specified,  all  other  ports  on  the  switch  are  ignored.  This  operand  is 
optional. 

Examples 

To  display  the  port  log  dump  for  a  port: 

switch :user>  portLogDumpPort  14 

time  task  event  port     cmd  args 


08 

:35 

27 

899 

tShell 

pstate 

14 

OL1 

08 

:35 

27 

899 

tReceive 

pstate 

14 

LR2 

08 

:35 

27 

916 

tReceive 

pstate 

14 

AC 

08 

:35 

28 

416 

interrupt 

sen 

14 

1 

08 

:35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08 

:35 

28 

433 

tFabric 

Tx 

14 

164 

02 f f f f rd, OOf f f f fd, 0005f f f f , 10000000 

08 

:35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08 

:35 

28 

433 

tReceive 

Rx 

14 

164 

03 f f f ffd, OOfffffd, 00050006, 02  000000 

08 

:35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00050006 
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08 

35 

28 

433 

tFabric 

ioctl 

14 

91 

10364638, 0 

08 

35 

28 

466 

tFabric 

ioctl 

14 

a7 

3c,  1 

08 

35 

28 

466 

tFabric 

pstate 

14 

LR1 

08 

35 

28 

466 

tReceive 

pstate 

14 

LR3 

08 

35 

28 

466 

tReceive 

pstate 

14 

AC 

08 

35 

28 

483 

tFabric 

Tx 

14 

96 

02 f f f f rd, OOf f f f fd, 0006f f f f , 11100060 

08 

35 

28 

483 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00060007 

08 

35 

28 

483 

tReceive 

Rx 

14 

96 

03 f f f f fd, OOf f f f fd, 00060007, 02100060 

08 

3  5 

2  8 

483 

1~  T  t~  ;a  r"i  o  m  ~\  i~ 
L,  1  J.  a.  1 1  fc>  1 L  L -L  L, 

14 

o 

nnfffffd  nnfffffd  nnn6nnn7 

08 

35 

28 

483 

tFabric 

ioctl 

14 

al 

0,0 

08 

35 

28 

483 

tFabric 

sen 

14 

5 

See  also 

portLogClear 

portLogShow 

upTime 
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portLogEventShow 

Displays  information  about  port  log  events. 

Synopsis 

portlogeventshow 

Availability 

admin 

Description 

Use  this  command  to  display  information  about  the  ID  associated  with  the  various  port  log  events.  The 
Disabled  field  indicates  if  the  port  log  for  that  event  ID  is  disabled  (1 )  or  enabled  (0). 

Operands 

none 

Examples 

Display  information  about  port  log  events: 


switch. 

admin>  portlogeventshow 

ID 

Event -Name 

Disabled 

1 

start 

0 

2 

disable 

0 

3 

enable 

0 

4 

ioctl 

0 

5 

Tx 

0 

6 

Txl 

0 

7 

Tx2 

0 

8 

Tx3 

0 

9 

Rx 

0 

10 

Rxl 

0 

11 

Rx2 

0 

12 

Rx3 

0 

13 

stats 

0 

14 

sen 

0 

15 

pstate 

0 

16 

rej  ect 

0 

17 

busy 

0 

18 

ctin 

0 

19 

ctout 

0 

20 

errlog 

0 

21 

loopscn 

0 

(continued  on  next 

page) 
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41 

n 
u 

42 
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n 
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U 

44 
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n 
u 

ft  j 

iu 

U 

A  £ 
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n 
U 

47 
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n 
u 

41  O 
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U 

A  Q 
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n 
U 

c  n 
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n 

51 

switch 

0 

52 

f iconq 

0 

53 

routing 

0 

See  also 

portLogTypeDi sable 
portLogTypeEnable 
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portLoginShow 

Displays  port  login  status. 

Synopsis 

portloginshow  [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  port  login  received  from  devices  attached  to  the  specified  port.  Some 
information  varies  with  the  switch  model  and  port  type.  The  following  lines  appear: 

Type  Type  of  login: 

fe         FLOGI,  fabric  login  to  fabric  F  Port. 

ff         PLOGI,  process  login  to  specific  N  Ports  or  well-known  address, 
such  as  name  server. 

fd         FDISC,  virtual  N_Port  login. 

PID  The  port's  24-bit  DJD. 

WWN  The  port's  world  wide  name. 

credit  The  credit  for  this  login  as  appropriate.  This  is  BB  (buffer-to-buffer)  credit  for 

FLOGIs  and  EE  (end-to-end)  credit  for  PLOGIs. 

df_sz  The  default  frame  size  for  this  login. 

cos  Class  of  services  supported.  This  can  be  a  combination  of  the  following 

bits: 

4  Class  of  service  includes  class  2. 
8         Class  of  service  includes  class  3. 

There  is  further  information  about  the  login  after  the  above  columns.  This  can  include  the  DID  (destination 
identifier)  that  the  port  is  logged  on  to. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

be  configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 
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Examples 

To  display  login  information  for  port  23: 


switch : admin>  portloginshow  23 

Type  PID 

world  wide  name 

credit 

df  sz 

cos 

fe  201700 

21:00:00:e0:8b:05:a3 

c9 

3 

2048 

8  scr=l 

ff  201700 

21:00:00:e0:8b:05:a3 

c9 

0 

0 

8     d_id=FFFC2  0 

ff  201700 

21:00:00:e0:8b:05:a3 

c9 

0 

0 

8  d_id=FFFFFC 

See  also 

f cpProbeShow 
portShow 
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portLogPdisc 

Sets  or  clears  the  debug_pdisc_flag. 

Synopsis 

portlogpdisc  lvl 

Availability 

admin 

Description 

Use  this  command  to  set  or  clear  the  debug_pdisc_flag. 

Operands 

This  command  has  the  following  operand: 

lvl        Specify  either  0  to  clear  the  flag  or  1  to  set  the  debug_pdisc_flag. 

Examples 

To  set  the  debug_pdisc_flag: 

switch: admin>  portlogpdisc  1 
PDISC  log  setting  =  1 

See  also 

none 
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port  Log  PortS  how 

Displays  information  about  port  log  port  settings. 

Synopsis 

portLogPortShow 

Availability 

admin 

Description 

Use  this  command  to  display  information  about  whether  the  port  log  for  various  ports  is  enabled  or 
disabled.  1  in  the  right  column  indicates  port  log  for  that  port  is  disabled,  and  0  indicates  port  log  for 
that  port  is  enabled. 

Operands 

none 

Examples 

To  disable  the  information  about  the  port  log  settings: 


switch 

admin>  portLogPortShow 

Port 

Disabled 

0 

1 

1 

0 

2 

0 

3 

0 

4 

0 

5 

0 

6 

0 

7 

0 

8 

0 

9 

0 

10 

0 

11 

0 

12 

0 

13 

0 

14 

0 

15 

0 

(continued  on  next  page) 

Fabric  OS  5.x  command  reference  guide  487 


1  £ 
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U 

z  z 

U 

Z  j 

U 

9  /I 

U 

Z  O 

U 

Z  0 

U 

n 
U 

Z  O 

U 

29 

0 

30 

0 

31 

0 

See  also 

portLogEventShow 
portLogReset 
portLogTypeDi sable 
portLogTypeEnable 
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portLog  Reset 

Enables  the  port  log  facility. 

Synopsis 

portlogreset 

Availability 

admin 

Description 

Use  this  command  to  enable  the  port  log  facility. 

See  portLogClear  for  events  that  might  disable  the  port  log  facility. 

Operands 

none 

Examples 

To  enable  the  port  log: 

switch :admin>  portlogreset 

See  also 

portLogPortShow 
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portLogResize 

Resizes  the  port  log  to  the  specified  number  of  entries. 

Synopsis 

portlogresize  num_entries 

Availability 

admin 

Description 

Use  this  command  to  resize  the  port  log  to  specified  number  of  entries.  If  num_entries  is  less  than  the 
already  configured  port  log  size,  no  change  is  effected. 

Operands 

This  command  has  the  following  operand: 

num_entries  Specifies  the  number  of  entries  to  which  portlog  needs  to  be 

resized.  The  valid  range  of  values  is  8, 1 92  to  1 6,384. 

Examples 

To  resize  the  port  log: 

switch : admin>  portlogresize  12288 

See  also 

portLogConf igShow 
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portLogShow 

Displays  the  port  log. 

Synopsis 

portlogshow   [count,   saved,  portid] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  page  by  page. 

The  portLogShow  command  displays  the  same  information  as  portLogDump,  but  it  enables  you  to 
press  Enter  after  each  page  of  output. 

Port  logs  are  circular  log  files  in  the  switch  firmware,  which  can  save  up  to  8,192  entries.  See 
portLogConf  igShow  to  display  the  current  port  log  size.  Once  the  log  is  full,  the  newest  log  entries 
delete  the  oldest  log  entries.  Port  logs  capture  switch-to-device,  device-to-switch,  switch-to-switch,  some 
device-to-device,  and  control  information. 

If  the  port  log  is  disabled,  the  following  message  displays  as  the  first  line.  See  portLogClear  command 
for  more  information. 

WARNING :  port  log  is  disabled 
The  following  information  displays  for  each  log  entry: 

Time  Displays  the  event  date  and  time  in  milliseconds.  The  clock  resolution  is  16 

milliseconds. 

Task  Displays  the  name  of  the  internal  switch  procedure  that  logged  the  event, 

interrupt  if  the  event  was  logged  in  interrupt  context,  or  unknown  if  the  task 
no  longer  exists. 

Event  Displays  the  task  event  that  generated  log  entry.  Possible  events  include: 


start 

A  switch  start  or  re-start  event 

disable 

A  port  is  disabled 

enable 

A  port  is  enabled 

ioctl 

A  port  I/O  control  is  executed 

Tx 

A  frame  is  transmitted  (class  is  indicated) 

Rx 

A  frame  is  received  (class  is  indicated) 

sen 

A  state  change  notification  is  posted 

pstate 

A  port  changes  physical  state 

reject 

A  received  frame  is  rejected 

busy 

A  received  frame  is  busied 

ctin 

A  CT  based  request  is  received 

ctout 

A  CT  based  response  is  transmitted 

errlog 

A  message  is  added  to  the  error  log 

loopscn 

A  loop  state  change  notification  is  posted 

create 

A  task  is  created 

debug 

A  debug  message 

nbrfsm 

Neighbor  state  transition 
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sn 

Speed  negotiation  states 

~  ZJ 

fcin 

Incoming  fibre  channel  information  unit 

fcout 

Outaoina  fibre  channel  information  unit 

ZJ  ZJ 

read 

Information  unit  header  loa  from  read  operation 

write 

Information  unit  header  log  from  write  operation 

err 

Information  unit  header  log  of  an  fc  error  frame 

frame 

fc  frame  payload 

nsRemQ 

Inter-switch  name  server  query 

rscn 

RSCN 

xalloc 

Allocate  an  exchange 

xfree 

Free  an  exchange 

xerr 

Exchange  error 

xstate 

Exchange  state 

payload 

Frame  payload 

Port  Displays  the  port  number  that  logged  the  event. 

Cmd  Defined  by  the  event.  Displays  a  value  defined  by  the  event  as  follows: 

ioctl  I/O  control  command  code 

Tx  &  Rx  Frame  payload  size 

sen  New  state  (see  state  codes  below) 

pstate  New  physical  state  (see  pstate  codes  below) 

ctin  The  CT-subtype: 

fc  Simple  Name  Server 

f8  Alias  Server 

ctout  Same  as  ctin  above. 

errlog  Error  level  (see  errModuleShow) 

loopscn  Current  loop  state  during  loop  initialization,  possible  values 


are: 

OLP 

Offline  (disconnected  or  nonparticipating) 

LIP 

FL_Port  entered  INITIALIZING  or  OPENJNIT  state 

LIM 

LISM  completed,  FL  Port  became  the  loop  master 

BMP 

Loop  init  completed,  FL_Port  in  MONITORING 

state 

OLD 

Port  transited  to  the  OLD_PORT  state 

TMO 

Loop  init  times  out 

Args  Displays  additional  information  about  the  event  as  follows: 


start  Start  type:  0  =  enable  ports,  1 00  =  disable  ports 

disable  State  (see  state  codes  next) 

enable  Mode:  0  =  normal 

nonzero  =  loopback 

Tx  &  Rx  Header  words  0, 1 ,4  (R_CTL,D_ID,S_ID,OX_ID,RX_ID)  and 

the  first  payload  word 

reject  FC-PH  reject  reason 

busy  FC-PH  busy  reason 
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ctin  Argument  0  is  divided  into  two  1 6-bit  fields: 

[A]  A  bit  map  indicating  whether  subsequent  args 
are  valid  (0001  means  argument  1  is  valid, 
0003  means  arguments  1  and  2  are  valid) 

Argument  1  is  the  first  word  of  the  CT  payload,  if 
applicable  (as  specified  in  [A]) 

Argument  2  is  the  second  word  of  the  CT 
payload,  if  applicable  (as  specified  in  [A]). 

[B]  The  CT-based  service  command  code 
ctout               Argument  0  is  also  divided  into  two  1 6-bit  fields: 

[A]  A  bit  map  indicating  whether  subsequent  args 
are  valid  (0001  means  argument  1  is  valid, 
0003  means  arguments  1  and  2  are  valid). 

[B]  The  CT  command  code  indicating  whether  an 
accept  (8002)  or  a  reject  (8001). 

If  [B]  is  an  accept,  argument  1  and  2  represents 
the  first  and  second  words  of  the  CT  payload,  if 
applicable  (as  specified  in  [A]). 

If  [B]  is  a  reject,  argument  1  contains  the  CT 
reject  reason  and  explanation  code. 

errlog  Error  type  (see  errModuleShow) 

loopscn         The  meaning  further  depends  on  each  loop  state: 

OLP  Offline  reason  code,  usually  zero 

LIP  Reason  code  for  LIPs  initiated  by  FL  Port,  if  the  code  value  is 

800x  (x  =  [1 ,0xc],  see  below),  or  the  lower  two  bytes  of  the 
LIP  received,  if  the  code  value  is  other  than  800x 

LIM  Usually  zero 

BMP  Memory  address  for  the  loop  bitmap 

OLD  Usually  zero 

TMO  Encoded  value  of  the  state  when  loop  init  timed  out  This 

value  is  usually  equal  to  the  first  word  of  a  loop  init  frame 
payload.  Other  possible  values  include: 

2  LIP  (req.  INITIALIZING)  timeout 

94F0F0     ARB(FO)  timeout 

40  CLS  timeout 

Codes  used  in  various  fields  are  as  follows: 
state 


pstate 


1 

Online 

2 

Offline 

3 

Testing 

4 

Faulty 

5 

E_Port 

6 

F_Port 

7 

Segmented 

AC 

Active  State 

LRl 

Link  Reset:  LR  Transmit  State 

LR2 

Link  Reset:  LR  Receive  State 

LR3 

Link  Reset:  LRR  Receive  State 
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LF1 

Link  Failure:  NOS  Transmit  State 

LF2 

Link  Failure:  NOS  Receive  State 

OL1 

Offline:  OLS  Transmit  State 

OL2 

Offline:  OLS  Receive  State 

OL3 

Offline:  Wait  for  OLS  State 

LIP  reason  8001 

Retry  loop  init 

8002 

Start  loop  after  gaining  sync 

8003 

Restart  loop  after  port  reset 

8004 

LIP  when  a  loop  hangs 

8005 

Restart  loop  if  LIP  received  when  sending  out  ARB(FO) 

8006 

LIP  when  an  OPN  returns 

8007 

Restart  loop  when  LIPs  received  in  OLD_PORT  AC  state 

8008 

Restart  loop  if  loop  not  empty  but  E  Port  loopback 

8009 

LIP  as  requested  by  the  LI  NIT  ELS  received 

800a 

LIP  as  requested  by  the  LPC  ELS  received 

800b 

Restart  loop  for  QuickLoop  looplet  setup 

800c 

Restart  loop  for  QuickLoop  looplet  re-initialization 

Speed  Negotiation  States 

INIT  Start  negotiation 

NM  Negotiate  master 

WS  Wait  for  signal 

NF  Negotiation  follow 

NC  Negotiation  complete 


For  a  full  explanation  of  the  information  displayed  by  this  command,  see  the  HP  StorageWorks  Fabric  OS 
5.x  procedures  user  guide. 

Operands 

This  command  has  the  followingoptional  Soperands: 

count  Specify  the  maximum  number  of  lines  to  display.  Only  the  most  recent 

count  entries  are  displayed. 

saved  Specify  a  nonzero  value  to  display  the  saved  port  log  from  the  last  switch 

fault.  See  upTime  for  a  list  of  conditions  that  cause  a  fault.  The  count 
is  ignored  when  displaying  the  saved  log. 

portid  Specify  the  area  number  of  port  to  be  displayed.  If  a  port  area  number  is 

specified,  all  other  ports  on  the  switch  are  ignored. 
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Examples 

To  view  the  port  log  for  a  port: 


switch :user> 

portLogShow 

24 

time 

task 

event 

port 

cmd 

args 

17  : 

:  05  : 

30  . 

,384 

PORT 

Rx 

0 

40 

02f f f f fd, 

OOf fff fd, 08fbf f f f , 14000000 

17  : 

:  05  : 

30  . 

.384 

PORT 

Tx 

0 

0 

cOff ff fd, 

OOf fff fd, 08fb0e02 

17  : 

:  05  : 

30. 

,384 

PORT 

debug 

0 

OOcOf fee, 

OOf d0118, 00000000, 00000001 

17  : 

:  05  : 

30. 

,389 

PORT 

Rx 

1 

40 

02fffffd,00fffffd, 08fdf f f f ,  14000000 

17  : 

:  05  : 

30  . 

,389 

PORT 

Tx 

1 

0 

cOff ff fd, 

OOf fff fd, 08fd0e03 

17  : 

:  05  : 

30  . 

,389 

PORT 

debug 

1 

OOcOf fee, 

00fd013c, 00000000, 00000001 

17  : 

:  05  : 

30. 

,504 

PORT 

Rx 

2 

40 

02 ff ff fd, OOff ff fd, 08fef fff , 14000000 

17  : 

:  05  : 

30. 

,504 

PORT 

Tx 

2 

0 

cOf f f f fd, OOf f f f fd, 08fe0e04 

17  : 

:  05  : 

30  . 

,504 

PORT 

debug 

2 

OOcOf fee, 

00fd0182, 00000000, 00000001 

17  : 

:  05  : 

30  . 

.507 

PORT 

Rx 

3 

40 

02ff ff fd, 

00fffffd,08ffffff, 14000000 

17  : 

:  05  : 

30. 

.507 

PORT 

Tx 

3 

0 

cOff ff fd, 

OOf fff fd, 08f f 0e05 

17  : 

:  05  : 

30. 

,508 

PORT 

debug 

3 

OOcOf fee, 

OOf d0148, 00000000, 00000001 

17  : 

:  05  : 

31. 

,081 

PORT 

Tx 

0 

40 

02ff ff fd, 

OOf fff fd, 0e06f f f f , 14000000 

17  : 

:  05  : 

31. 

,082 

PORT 

debug 

0 

OOcOf fee, 

00fd0188, 14  000000, 00000001 

17  : 

:  05  : 

31. 

,084 

PORT 

Rx 

0 

0 

c0fffffd,00fffffd,  0e060902 

17  : 

:  05  : 

31. 

,772 

PORT 

Tx 

1 

40 

02f f ff fd, 

OOf fff fd, 0e07f f f f , 14000000 

17  : 

:05: 

31. 

.772 

PORT 

debug 

1 

OOcOf fee, 

00fd014a, 14  000000, 00000001 

17  : 

:05: 

31. 

.774 

PORT 

Rx 

1 

0 

cOff ff fd, 

OOff ff fd, 0e070906 

17  : 

:05: 

31. 

,775 

PORT 

Tx 

2 

40 

02f f ff fd, 

OOf fff fd, 0e08f f f f ,  14000000 

17  : 

:05: 

31. 

.775 

PORT 

debug 

2 

OOcOf fee, 

OOf d015c, 14000000, 00000001 

17  : 

:05: 

31. 

,777 

PORT 

Rx 

2 

0 

cOff ff fd, 

OOf fff fd, 0e080907 

17  : 

:05: 

31. 

.778 

PORT 

Tx 

3 

40 

02ff ff fd, 

OOf fff fd, 0e09f f f f , 14000000 

17  : 

:05: 

31. 

.779 

PORT 

debug 

3 

OOcOf fee, 

OOf d015e, 14000000, 00000001 

17  : 

:05: 

31. 

,782 

PORT 

Rx 

3 

0 

c0fffffd,00fffffd, 0e090908 

See  also 

portLogClear 

portLogDump 

upTime 
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portLogShowPort 

Displays  the  port  log  of  specified  port,  with  page  breaks. 

Synopsis 

portlogshowport  [portid] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  port  log,  showing  22  entries  at  a  time.  It  is  identical  to 

portLogDumpPort,  except  that  portLogDumpPort  does  not  prompt  the  user  to  press  Enter  between 
each  page  of  output. 

If  the  port  log  is  disabled,  the  following  message  is  printed  as  the  first  line  (see  portLogClear  for 
details): 

WARNING:  port  log  is  disabled 
See  the  portLogDump  command  for  more  information  on  the  data  returned  by  this  command. 

Operands 

This  command  has  the  following  operand: 

portid  Specify  a  nonzero  value  that  specifies  which  port  appears. 

Examples 

To  display  a  port  log  for  port  14: 

switch :user>  portLogShowPort  14 

time  task  event  port     cmd  args 


08 

35 

28 

483 

tFabric 

sen 

14 

0 

08 

35 

27 

899 

tShell 

pstate 

14 

OL1 

08 

35 

27 

899 

tReceive 

pstate 

14 

LR2 

08 

35 

27 

916 

tReceive 

pstate 

14 

AC 

08 

35 

28 

416 

interrupt 

sen 

14 

1 

08 

35 

28 

433 

tFabric 

ioctl 

14 

90 

101d9910, 0 

08 

35 

28 

433 

tFabric 

Tx 

14 

164 

02 f f f f fd, OOf f f f fd, 0005f f f f , 10000000 

08 

35 

28 

433 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOf f f f fd, 00050006 

08 

35 

28 

433 

tReceive 

Rx 

14 

164 

03fffffd, OOfffffd, 00050006,  02  000000 

08 

35 

28 

433 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00050006 

08 

35 

28 

433 

tFabric 

ioctl 

14 

91 

103646d8, 0 

08 

35 

28 

433 

tFabric 

ioctl 

14 

92 

103646d8, 0 

08 

35 

28 

466 

tFabric 

ioctl 

14 

a7 

3c,  1 

08 

35 

28 

466 

tFabric 

pstate 

14 

LR1 

08 

35 

28 

466 

tReceive 

pstate 

14 

LR3 

08 

35 

28 

466 

tReceive 

pstate 

14 

AC 

(continued  on  next  page) 
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08 

35 

28 

483 

tFabric 

Tx 

14 

96 

02fffffd, OOfffffd, 0006ffff, 11100060 

08 

35 

28 

483 

tReceive 

Rx 

14 

0 

cOf f f f fd, OOfffffd, 00060007 

08 

35 

28 

483 

tReceive 

Rx 

14 

96 

03 f f f f fd, OOfffffd, 00060007, 02100060 

08 

35 

28 

483 

tTransmit 

Tx 

14 

0 

cOf f f f fd, OOfffffd, 00060007 

08 

35 

28 

483 

tFabric 

ioctl 

14 

al 

0,0 

08 

35 

28 

483 

tFabric 

sen 

14 

5 

(output  truncated) 

See  also 

portLogClear 

portLogShow 

upTime 
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portLogTypeDisable 


Disables  the  port  log  of  a  specified  type. 

Synopsis 

portlogtypedisable  id 

Availability 

admin 

Description 

Use  this  command  to  disable  the  port  log  for  a  specified  port  log  type. 

Operands 

This  command  has  the  following  operand: 

id  Specify  a  nonzero  value  that  corresponds  to  the  port  log  type  to  be 

disabled.  The  values  corresponding  to  different  log  types  can  be 
obtained  by  running  portLogEventShow. 

Examples 

To  disable  event  2  from  reporting  to  the  port  log: 

switch: admin>  portlogtypedisable  2 

See  also 

portLogEventShow 
portLogTypeEnable 
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portLogTypeEnable 


Enables  the  port  log  of  a  specified  type. 

Synopsis 

portlogtypeenable  id 

Availability 

admin 

Description 

Use  this  command  to  enable  the  port  log  for  a  specified  port  log  type. 

Operands 

This  command  has  the  following  operand: 

id  Specify  a  nonzero  value  that  corresponds  to  the  port  log  type  to  be 

enabled.  The  values  corresponding  to  different  log  types  can  be 
obtained  by  running  portLogEventShow. 

Examples 

To  enable  event  2  to  report  to  the  port  log: 

switch : admin>  portlogtypeenable  2 

See  also 

portLogEventShow 
portLogTypeDi sable 
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portLoopbackTest 

Functional  test  of  port  N->N  path. 

Synopsis 

portloopbacktest   [--slot  number]  [-nframes  count] [-lb_mode  mode] 
[-spd_mode  mode]  [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  functional  operation  of  the  switch  by  sending  frames  from  the  port  N 
transmitter  and  looping  them  back  into  the  same  port  N  receiver.  The  loopback  is  done  at  the  parallel 
loopback  path.  The  path  exercised  in  this  test  does  not  include  the  media  or  the  fiber  cable. 

Only  one  frame  is  transmitted  and  received  at  a  time.  No  external  cable  is  required  to  run  this  test.  The 
port  LEDs  flicker  green  rapidly  while  the  test  is  running. 

Following  is  the  test  method: 

1.  Set  all  ports  for  parallel  loopback. 

2.  Create  a  frame  F  of  maximum  data  size  (2, 1 1 2  bytes). 

3.  Transmit  frame  F  through  port  N. 

4.  Pick  up  the  frame  from  the  same  port  N. 

5.  Check  the  eight  statistic  error  counters  for  nonzero  values: 

ENC_in,  CRC_err,  TruncFrm,  FrmTooLong,  BadEOF,  Enc_out,  BadOrdSet,  DiscC3 

6.  Check  if  the  transmit,  receive,  or  class  3  receiver  counters  are  stuck  at  some  value. 

7.  Check  if  the  number  of  frames  transmitted  is  not  equal  to  the  number  of  frames  received. 

8.  Repeat  step  2  through  step  7  for  all  ports  present  until: 

■  The  number  of  frames  (or  passcount)  requested  is  reached. 

■  All  ports  are  marked  bad. 

At  each  pass,  the  frame  is  created  from  a  different  data  type.  If  seven  passes  are  requested,  seven 
different  data  types  are  used  in  the  test.  If  eight  passes  are  requested,  the  first  seven  frames  use  unique 
data  types,  and  the  eighth  is  the  same  as  the  first.  The  seven  data  types  are: 

1)  CSPAT:   0x7e,    0x7e,    0x7e,    0x7e,  ... 

2)  BYTE_LFSR:    0x69,    0x01,    0x02,    0x05,  ... 

3)  CHALF_SQ:   0x4a,    0x4a,    0x4a,    0x4a,  ... 

4)  QUAD_NOT:    0x00,    Oxff,    0x00,    Oxff,  ... 

5)  CQTR_SQ:    0x7  8,    0x7  8,    0x7  8,    0x7  8,  ... 

6)  CRPAT:    Oxbc,    Oxbc,    0x23,    0x47,  ... 

7)  RANDOM:   0x25,    0x7f,    0x6e,    0x9a,  ... 

Because  this  test  does  not  include  the  media  or  the  fiber  cable  in  its  test  path,  its  results  combined  with  the 
results  of  crossPortTest  and  spinSilk  (both  of  which  loop  frames  using  an  external  loopback 
cable)  can  be  used  to  determine  which  components  of  the  switch  are  faulty. 
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Operands 


This  command  has  the  following  operands: 


-slot  number 


-nframes  count 


-lb  mode  mode 


-spd_mode  mode 


-ports  itemlist 


Specify  the  slot  number  on  which  the  diagnostic  will  operate.  The 
ports  specified  will  be  relative  to  this  slot  number.  The  default  is  set  to 

0  and  designed  to  operate  on  fixed-port-count  products. 

Specify  the  number  of  frames  to  send.  The  test  will  progress  until  the 
specified  number  of  frames  has  been  transmitted  on  each  port.  The 
default  value  is  1 0. 

Specify  the  loopback  mode  for  the  test.  By  default,  this  test  uses 
internal  loopback.  Valid  values  are  as  follows: 

1  Port  Loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 

Specify  the  speed  mode  for  the  test.  This  parameter  is  used  only  with 
Bloom  and  Condor  ASIC-based  products,  where  it  controls  the  speed 
at  which  each  port  is  operated.  For  1  Gb/s-only  products,  it  is 
ignored.  The  exact  operation  of  speed  modes  5  through  8  depends 
upon  the  loopback  mode  selected.  When  speed  modes  5  through  8 
are  used  with  cables,  they  must  be  connected  even  to  odd  or  the  test 
will  fail. 

0  Runs  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 

1  Runs  test  at  1  Gb/s. 

2  Runs  test  at  2  Gb/s  (Bloom  default). 

4         Runs  test  at  4  Gb/s  (Condor  default). 

For  -lb_mode  set  to  0  or  1 ,  the  following  speed  modes  are 
available  to  test  the  speed  negotiation: 

3  Set  all  even  ports'  speed  for  autonegotiate;  set  all  odd  ports' 
speed  for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate;  set  all  odd  ports' 
speed  for  2  Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate;  set  all  even  ports' 
speed  for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate;  set  all  even  ports' 
speed  for  2  Gb/s. 

For  IbMode  ==  2,3  the  following  speed  modes  are  available  to  test 
FIFO  underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gb/s;  set  all  odd  ports' 
speed  for  1  Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s;  set  all  odd  ports' 
speed  for  2  Gb/s. 

Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  in 
the  current  switch  are  tested.  This  option  can  be  used  to  restrict 
testing  to  the  specified  ports. 


Examples 


To  run  a  functional  test  of  a  connection: 


switch :admin>  portloopbacktest  -ports  1/38-1/45  -nframes  1  -lb_mode  1 

Running  Port  Loopback  Test  .... 

passed. 
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Diagnostics 

Following  are  possible  error  messages  if  failures  are  detected: 

DATA 

ERRSTAT 

INIT 

PORTDIED 
STATS 
TIMEOUT 
XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 

cmemRetentionTest 

cmiTest 

crossPortTest 

itemList 

portRegTest 

spinSilk 

sraraRetentionTest 
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portName 

Assigns  or  displays  a  port  name. 

Synopsis 

portname  [ slotnumber/] portnumber,  name 

Availability 

admin 

Description 

Use  this  command  to  assign  or  display  a  port  name.  Both  port_number  and  name  operands  are 
optional  for  this  command. 

With  both  the  operands  present,  the  port  name  string  will  be  assigned  to  the  port.  With  only  the  port 
name  operand,  the  previously  assigned  port  name  will  be  displayed.  With  no  operands,  the  port  names 
of  all  the  ports  present  will  be  displayed. 

The  port  name  is  a  string  of  32  characters  or  fewer.  It  can  consist  of  white  spaces  or  printable  characters, 
excluding  the  characters  comma  (  ,  )  and  semicolon  ( ;  ).  By  default,  a  port  has  no  name  until  it  is 
explicitly  assigned  by  the  user. 

A  null  string  (that  is,  no  name  specified)  is  used  as  the  default  port  name  when  a  port  has  no 
user-assigned  name.  A  port  name  can  be  reset  to  the  default  value  by  executing  the  portName  command 
with  the  second  operand  a  null  string. 

Like  all  other  configurable  port  attributes,  port  name  persists  across  reboots  and  power  cycles.  It  will  not 
be  affected  by  conf  igDef ault  command,  but  it  will  be  cleared  by  portCf gDef ault. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 

configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

name  Specify  a  port  name.  The  port  name  is  a  character  string  from  1  to  32 

characters,  including  spaces  and  characters  excluding  commas, 
semicolons,  and  asterisks.  To  erase  a  port  name,  specify  this  operand  as 
an  empty  string.  Quotation  marks  are  optional.  This  operand  is  optional; 
if  omitted,  it  displays  the  current  port  name. 

Without  operands,  the  port  names  of  all  ports  present  are  displayed. 

Examples 

To  name  to  a  port: 


switch : admin> 

portname 

1/3,    "Tape  drive  8" 

switch : admin> 

portname 

1/3 

Tape  drive  8 

See  also 

conf igDef ault 
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portCfgDe fault 
portShow 
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portPerfShow 

Displays  port  throughput  performance  in  bytes,  kilobytes,  or  megabytes. 

Synopsis 

portperfshow  [interval] 

Availability 

all  users 

Description 

Use  this  command  to  display  throughput  information  for  all  ports  on  the  switch.  Data  appears  in  8  or  1 6 
columns,  one  column  per  port  plus  one  column  that  displays  the  total  for  these  ports.  Results  appear  every 
second  or  over  the  specified  interval,  until  Enter,  Ctrl-c,  or  Ctrl-d  is  pressed. 

This  command  displays  the  number  of  bytes  received  plus  the  number  of  bytes  transmitted  per  interval. 
Throughput  values  are  displayed  as  either  bytes,  kilobytes  (k),  megabytes  (m),  or  gigabytes  (g).  Values 
are  always  rounded  down. 

Operands 

This  command  has  the  following  operand: 

interval  Specify  the  interval,  in  seconds,  between  each  sample.  The  default  is 

one  second.  This  operand  is  optional. 

Examples 

To  display  port  throughput  for  a  switch: 


switch 

user>  portperfshow  2  0 

0  12 

3       4  5 

6 

7 

8 

9 

10     11     12     13  14 

15 

Total 

slot  1 

0       0  23k 

0       0  134k 

0 

12m 

0  7 

3m 

0  312m     0  l.lg  0 

0 

1.4g 

slot  2 

0  212m  0 

0  784k  0 

0 

0 

43m 

0 

85m     0  275k     0  498 

0 

341m 

0  12 

3       4  5 

6 

7 

8 

9 

10     11     12     13  14 

15 

Total 

slot  1 

0       0  26k 

0       0  160k 

0 

13m 

0  7 

5m 

0  310m     0  1.2g  0 

0 

1.3g 

slot  2 

0  178m  0 

0  812k  0 

0 

0 

43m 

0 

87m     0  272k     0  330 

0 

310m 

See  also 

port Stats Show 
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portRegTest 

Reads  and  writes  test  of  the  ASIC  SRAMs  and  registers. 

Synopsis 

portregtest   [--slot  slotnumber]  [-ports  itemlist]  [-skiptests  mask]  [-verbose 
mode] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  SRAM  and  register  data  bits  in  each  ASIC  can  be  independently  written 
and  read. 

The  test  method  used  is  to  write  a  walking  1  pattern  to  each  bit  location.  This  is  done  by  writing  a  pattern 
of  0x00000001  to  register  N.  Read  and  ensure  that  the  same  pattern  previously  written  is  read  back. 
Shift  the  pattern  to  the  left  by  1  bit  (to  0x00000002)and,  repeat  the  write,  read,  and  compare  cycle. 
Shift  again  and  repeat  until  the  last  writable  bit  in  register  N  is  reached  (0x80000000  for  a  32-bit 
register). 

For  example,  a  6-bit  register  is  effectively  tested  with  the  following  patterns: 

0x0001  0x0002  0x0004  0x0008 

0x0010  0x0020  0x0040  0x0080 

0x0100  0x0200  0x0400  0x0800 

0x1000  0x2000  0x4000  0x8000 

Repeat  these  steps  until  all  ASIC  SRAMs  and  registers  are  tested. 

Operands 

This  command  has  the  following  operands: 

--slot  slotnumber        Specify  the  slot  number  on  which  the  diagnostic  operates.  The 

ports  specified  will  be  relative  to  this  slot  number.  The  default 
is  0. 

-ports  itemlist  Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade 

ports  in  the  specified  slot  are  used.  See  itemList  for  further 
details. 

-skiptests  mask  A  bit  mask  that  defines  which  of  the  register  test  subtests  to 

skip.  By  default,  all  subtests  are  performed.  Valid  mask  values 
include  one  or  more  of  the  following: 

0x2  Skip  retry  register  test. 

0x4  Skip  statistics  register  test. 

0x8  Skip  walk-1  test. 

0x1 0  Skip  credit  counter  test. 

-verbose  mode  Specify  a  nonzero  value  to  enable  verbose  mode.  The  default 

value  is  to  disable  this  mode. 
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Examples 

To  run  a  bit  write/ read  test  of  the  ASIC  SRAMs  and  registers: 

switch :admin>  portregtest  -ports  1/0-1/15 

Running  Port  Register  Test  .... 

Test  Complete:    "portregtest"  Pass  1  of  1 

Duration  0  hr,    0  min  &  33  sec  (0:0:33:447). 

passed. 

Diagnostics 

When  this  command  detects  failures,  the  test  might  report  one  or  more  of  the  following  error  messages 

BUS_TIMEOUT 

REGERR 

REGERR_UNRST 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 
cmeraRe  tentionTest 
cmiTest 
cross PortTest 
itemList 

portLoopbackTest 
spinSilk 

sramRe tentionTest 
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portRouteShow 


Displays  routing  tables  for  the  specified  port. 


Synopsis 


portrouteshow   [ slotnumber/] portnumber 


Availability 

all  users 


Description 

Use  this  command  to  display  the  port  address  ID  and  the  contents  of  the  following  port  routing  tables: 


External  unicast  routing  table 


Internal  unicast  routing  table 


Broadcast  routing  table 


Displays  how  the  specified  port  forwards  unicast  frames  to 
remote  domains  in  the  following  format: 

domain_number :  ports_bitmap 

•  domain_number  is  the  remote  domain  ID  to  which 
frames  are  ultimately  routed 

•  ports_bitmap  contains  the  port  number  on  the  ASIC 
pair  to  which  frames  for  the  domain  ID  forward  in 
bitmap  hex  format;  for  example,  0x0100  indicates  port 
8  on  the  ASIC  pair 

The  arrangements  of  ports  on  an  ASIC  pair  is  specific  to  the 
system  type.  For  any  active  port,  this  table  contains  at  least 
one  entry,  which  routes  unicast  frames  destined  to  the 
embedded  port  (value  0x1 0000)  of  the  local  domain. 

Displays  how  the  specified  port  forward  unicast  frames  to 
locally  attache  Nx_Ports  in  the  following  format: 

area_number :  ports_bitmap 

•  area_number  represents  the  area  number  of  a  device 
(or  set  of  looped  devices)  attached  to  the  local  switch 

•  The  format  of  ports_bitmap  is  the  same  as  the 
external  unicast  routing  table. 

Displays  how  the  specified  port  forwards  broadcast  frames. 
There  is  one  bit  map  entry  in  this  table,  similar  to  the  bit 
maps  in  the  other  tables;  however,  this  table  typically  has 
only  Bit  16  set  (value  0x10000),  indicating  this  port 
always  routes  broadcast  frames  to  the  embedded  port,  for 
handling  by  the  firmware. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


portnumber 


For  bladed  systems  only,  specifies  the  slot  number  of  the  port  to 
display,  followed  by  a  slash  (/). 

Specifies  the  number  of  the  port  to  display,  relative  to  its  slot  for 
bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 
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Examples 

To  display  the  routing  tables  for  a  port: 

switch:user>  portrouteshow  4/15 
port  address  ID:  0x02bf00 
external  unicast  routing  table: 
1:   0x4  (vc=3) 
2:   0x10000  (vc=0) 
internal  unicast  routing  table: 

60:   0x8000  (vc=2) 

63:    0x1000  (vc=5) 
broadcast  routing  table: 

0x10000 

See  also 

bcastShow 
f abricShow 
switchShow 
topologyShow 
uRouteShow 
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portShow 

Displays  port  status. 

Synopsis 

portshow   [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  status  information  for  the  specified  port,  as  shown  in  Table  1  7.  Information 
varies  with  the  switch  model  and  port  type. 

Table  17   portshow  display  fields 


Field 

Description 

portName 

Name  assigned  to  the  port  by  the  command  of  the  same  name. 

portHealth 

Current  health  of  the  port  (Fabric  Watch  license  required). 

Authentication 

Authentication  type  and  associated  parameters,  if  applicable,  used  on 
the  port  at  port  online  or  when  enabling  security,  whichever  occurs  last. 
States  include: 

None 

No  authentication  was  done. 

FCAP 

FCAP  authentication  was  done. 

DHCHP 

DH-CHAP  authentication  was  done.  It  also  displays  the 
DH  group  and  hash  used  for  authentication. 

portDisableReason 

The  reason  that  a  port  has  been  disabled,  if  it  has  not  been  disabled  by 

portDisable  or  portCf  gPersistentDisable. 

portCFlags 

Port  control  flags. 

portFlags 

Bit  map  of  port  status  flags,  including  information  on  the  type  of  port, 
whether  it  is  fully  online,  and  whether  logins  have  been  accepted  on  it. 

portType 

Port  type  and  revision  numbers. 

portState 

Port  SNMP  state: 

Online 

Upand  running 

Offline 

Not  online;  portPhys  gives  details 

Testing 

Running  diagnostics 

Faulty 

Failed  diagnostics 

Persistently 
Disabled 

Persistently  disabled 

portPhys 

Port  physical  state: 
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Table  17   portshow  display  fields  (continued) 


Field 

Description 

No_Card 

No  interface  card  present 

No_Module 

No  module  (SFP  or  other)  present 

No_Light 

Module  not  receiving  light 

No_Sync 

Receiving  light  but  out  of  sync 

InSync 

Receiving  light  and  in  sync 

LaserFlt 

Module  is  signaling  a  laser  fault 

Port_Flt 

Port  marked  faulty 

Diag_Flt 

Port  failed  diagnostics 

Lock_Ref 

Locking  to  the  reference  signal 

portScn 

Last  state  change  notification  for  port. 

port  generation  number 

Port  generation  number  for  the  last  offline  state  change. 

portid 

24-bit  port  ID. 

portlfid 

User  port's  interface  ID. 

r~\r\  rf\A/\A/n 

LJt_J|  1  V  V  W  l  1 

PortWWN. 

portWwn  of  devices 
connected 

Port  WWNs  of  connected  devices. 

Distance 

The  port's  long-distance  level.  In  case  of  LD  mode,  the  user  configured 
limit  and  actual  distances  also  are  displayed.  See 

portCf gLongDi stance. 

UUI  IJUCCU 

The  port's  fixed  speed  (1,  2,  or  4  Gb/s)  or  negotiated  speed  (Nl,  N2, 
or  N4  Gb/s). 

Interrupts 

Total  number  of  i 

nterrupts. 

Unknown 

Interrupts  that  are  not  counted  elsewhere. 

Lli 

Low-level  interface  (physical  state,  primitive  sequences). 

Proc_rqrd 

Frames  delivered  for  embedded  NPort  processing. 

Timed_out 

Frames  that  have 

timed  out. 

Rxf  lushed 

Frames  requiring 

translation. 

Txunavail 

Frames  returned  from  an  unavailable  transmitter. 

Free_buffer 

Free  buffer  available  interrupts. 

Overrun 

Buffer  overrun  interrupts. 
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Table  17   portshow  display  fields  (continued) 


Field 

Description 

Suspended 

Transmission  suspended  interrupts. 

Parity_err 

Central  memory  parity  errors. 

2_parity_err 

Secondary  Tx  parity  errors. 

CMI_bus_err 

Control  message  interface  errors. 

The  second  column  displays  link  error  status  block  counters. 

The  third  column  displays  the  number  of  F  RJTs  and  FBSYs  generated.  For  L_Ports,  the  third  column  also 
displays  the  number  of  loop  initialization  protocols  (LIPs)  received,  number  of  LIPs  transmitted,  and  the  last 
LIP  received. 


Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to 

be  configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for 

bladed  systems.  Use  switchShow  to  display  a  list  of  valid 
ports. 
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Examples 

To  display  the  state  of  a  port: 

switch :user>  portshow  2/15 
portName :  Tape  drive  8 
portHealth:  HEALTHY 


Authentication:  None 

portDisableReason:  None 

portCFlags :  0x1 

portFlags:  0x903 
LOGICAL_ONLINE  LOGIN 


PRESENT  ACTIVE  E  PORT  G  PORT  U  PORT 


portType:  10.0 
portState:   1  Online 
portPhys :     6  In_Sync 
portScn:       16       E_Port        Trunk  port 
port  generation  number:  0 
portld:  012f00 
portlfld:  43320010 
portWwn:  20:2f:00:60:69:e4:20:42 
portWwn  of  device (s)  connected: 
None 

Distance:  normal 
portSpeed:  N4Gbps 


Interrupts : 

0 

Link_f ailure : 

0 

Unknown : 

0 

Loss_of_sync : 

3 

Lli: 

15 

Loss_of_sig : 

2 

Proc_rqrd : 

0 

Protocol_err : 

0 

Timed_out : 

0 

Invalid_word : 

0 

Rx_f lushed: 

0 

Invalid_crc : 

0 

Tx_unavail : 

0 

Delim_err : 

0 

Free_buf f er : 

0 

Address_err : 

0 

Overrun : 

0 

Lr_in : 

3 

Suspended: 

0 

Lr_out : 

1 

Parity_err : 

0 

01s_in: 

0 

2  parity  err : 

0 

Ols_out : 

3 

CMI_bus_err : 

0 

See  also 


authUtil 

portCf gLongDi stance 
portLoginShow 
portName 
switchShow 


Frjt: 
Fbsy : 
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portStats64Show 

Displays  the  64-bit  hardware  statistics  for  a  port. 

Synopsis 

ports tats 6 4 show   [ slotnumber/] portnumber 

Availability 

all  users 

Description 

Use  this  command  to  display  the  following  hardware  statistics  for  a  port.  Two  integers  are  reported  for 
most  values.  In  such  cases,  the  top  word  is  the  most  significant. 


stat64_wtx 

Number  of  4-byte  words  transmitted. 

stat64_wrx 

k  i       i          r  a  i     i             i  i 

Number  ot  4-byte  words  received. 

stat64_ftx 

Frames  transmitted. 

stat64_frx 

Frames  received. 

stat64_c2_frx 

Class  2  frames  received. 

stat64_c3_frx 

Class  3  frames  received. 

stat64_lc_rx 

Link  control  frames  received. 

stat64_mc_rx 

Multicast  frames  received. 

stat64_mc_to 

Multicast  timeouts. 

stat64_mc_tx 

kill'          if                  ■  *iil 

Multicast  trames  transmitted. 

timo4_rdy_pn 

lime  KKDY  high  priority. 

tim64_txcrd_z 

Time  BB  credit  zero. 

er64_enc_in 

r          1  •                          •  1       f  f 

encoding  errors  inside  ot  trames. 

er64_crc 

Frames  with  CRC  errors. 

er64_trunc 

Frames  shorter  than  minimum. 

er64_toolong 

Frames  longer  than  maximum. 

er_bad_eof 

Frames  with  bad  end-of-frame. 

er64_enc_out 

Encoding  error  outside  of  frames. 

er64_disc_c3 

Class  3  frames  discarded. 

stat64_rateTxFrame 

Tx  frame  rate  (fr/sec). 

stat64_rateRxFrame 

Rx  frame  rate  (fr/sec). 

stat64_rateTxPeakFrame 

Tx  peak  frame  rate  (fr/sec). 

stat64_rateRxPeakFrame 

Rx  peak  frame  rate  (fr/sec). 

stat64_rateTxByte 

Tx  Byte  rate  (bytes/sec). 

stat64_rateRxByte 

Rx  Byte  rate  (Bytes/sec). 

stat64_rateTxPeakByte 

Tx  peak  Byte  rate  (Bytes/sec). 

stat64_rateRxPeakByte 

Rx  peak  Byte  rate  (Bytes/sec). 

stat64_PRJTFrames 

Number  of  P_RJT  frames  transmitted. 

stat64_PBSYFrames 

Number  of  P  BSY  transmitted. 

stat64_inputBuffersFull 

Occasions  on  which  input  buffers  are  fu 

stat64  rxClassl  Frames 

Class  1  frames  received. 
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Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 

configured,  followed  by  a  slash  (/). 

portnumber  Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

Examples 

To  display  the  64-bit  hardware  statistics  for  a  port: 


switch:user>  portstats64show  4/15 

stat64_wtx 

0 

top_int   :   4-byte  words  transmitted 

316 

bottom_int   :   4-byte  words  transmitted 

stat64_wrx 

0 

top_int   :   4-byte  words  received 

1486 

bottom_int   :   4-byte  words  receive 

stat64_f tx 

0 

top_int   :   Frames  transmitted 

69 

bottom_int   :   Frames  transmitted 

stat64_f rx 

0 

top_int  :  Frames  received 

73 

bottom_int   :   Frames  received 

stat64_c2_frx 

0 

top_int  :  Class  2  frames  received 

0 

bottom_int   :   Class  2  frames  received 

stat64_c3_f rx 

0 

top_int   :  Class  3  frames  received 

37 

bottom_int   :   Class  3  frames  received 

stat64_lc_rx 

0 

top_int   :  Link  control  frames  received 

8 

bottom_int   :   Link  control  frames  received 

stat64_mc_rx 

0 

top_int   :  Multicast  frames  received 

0 

bottom_int   :  Multicast  frames  received 

stat64_mc_to 

0 

top_int   :  Multicast  timeouts 

0 

bottom_int   :  Multicast  timeouts 

stat64_mc_tx 

0 

top_int   :  Multicast  frames  transmitted 

0 

bottom_int   :  Multicast  frames  transmitted 

tim64  rdv  pri 

0 

top_int   :  Time  R_RDY  high  priority 

60438254 

bottom_int   :  Time  R_RDY  high  priority 

tim64_txcrd_z 

0 

top_int   :  Time  BB_credit  zero 

2 

bottom_int   :  Time  BB_credit  zero 

er64_enc_in 

0 

top_int   :   Encoding  errors  inside  of  frames 

0 

bottom_int   :  Encoding  errors  inside  of  frames 

(continued  on 

next  page) 
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s—\  -y~  C-\  A              -y-  /—* 

fci-L  D  y  C-L  C_ 

n 
u 

top_ 

_int 

:   Frames  with  CRC  errors 

n 
u 

bottom_ 

int 

:   Frames  with  CRC  errors 

^  "V"         A          \~  VI  T  T1  ^1 

fci-L  D  ^  LI  U.I1C 

n 
u 

top_ 

_int 

:   Frames  shorter  than  minimum 

n 
u 

bottom_ 

int 

:   Frames  shorter  than  minimum 

ei*64  too  long 

u 

top_ 

_int 

:   Frames  longer  than  maximum 

n 
u 

bottom_ 

int 

:   Frames  longer  than  maximum 

ci-L  DdU  fc!0  -L 

n 
u 

top_ 

_int 

:   Frames  with  bad  end-of-frame 

n 
u 

bottom_ 

int 

:   Frames  with  bad  end-of-frame 

ei*6  4  enc  out 

u 

top_ 

_int 

:   Encoding  error  outside  of  frames 

Q  1  ^  1  1 

bottom_int  : 

Encoding  error  outside  of  frames 

er64_disc_c3 

0 

top_ 

_int 

:   Class  3  frames  discarded 

0 

bottom_ 

int 

:  Class  3  frames  discarded 

stat64_rateTxFrame 

17 

Tx 

frame  rate  (fr/sec) 

stat64_rateRxFrame 

17 

Rx 

frame  rate  (fr/sec) 

stat64_rateTxPeakFrame 

17 

Tx 

peak  frame  rate  (fr/sec) 

stat64_rateRxPeakFrame 

17 

Rx 

peak  frame  rate  (fr/sec) 

stat64_rateTxByte 

79 

Tx 

Byte  rate  (bytes/sec) 

stat64_rateRxByte 

371 

Rx 

Byte  rate  (Bytes/sec) 

stat6 4_rateTxPeakByte 

79 

Tx 

peak  Byte  rate  (Bytes/sec) 

stat64_rateRxPeakByte 

371 

Rx 

peak  Byte  rate  (Bytes/sec) 

stat64_PRJTFrames 

0 

top_int   :   4-byte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

stat64_PBSYFrames 

0 

top_int   :   4-byte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

stat64_inputBuf f ersFull 

0 

top_int   :   4-byte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

stat64_rxClasslFrames 

0 

top_int   :   4-byte  words  transmitted 

0 

bottom_int   :   4-byte  words  transmitted 

See  also 


portStatsClear 
port Stats Show 
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portStatsClear 

Clears  the  hardware  statistics  of  a  specified  switch  port. 

Synopsis 

portstatsclear   [slotnumber/ ] portnumber 

Availability 

admin 

Description 

Use  this  command  to  clear  the  hardware  statistics,  including  the  AL_PA-based  CRC  monitor,  end-to-end 
monitor,  and  filter-based  monitor  statistics,  for  a  specified  switch  port.  For  platforms  with  a  Bloom-based 
ASIC,  the  command  also  clears  the  hardware  statistics  for  associated  ports  in  the  target  port  quad.  For 
platforms  with  a  Condor-based  ASIC,  the  command  clears  the  hardware  statistics  only  on  the  port 
designated. 

Operands 

This  command  has  the  following  operands: 

slotnumber       For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 
configured,  followed  by  a  slash  (/). 

portnumber       Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

Examples 

To  clear  the  statistics  for  a  port: 

switch :admin>  portstatsclear  4/15 

See  also 

portStats64Show 
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portStatsShow 


Displays  port  hardware  statistics. 


Synopsis 


portstatsshow   [slotnumber/] portnumber 


Availability 

all  users 

Description 

Use  this  command  to  display  port  hardware  statistics  counters.  Some  counters  are  platform-  and 
port-specific  and  appear  only  with  those  platforms  and  ports.  All  statistics  have  a  maximum  32-bit  value 
of  4,294,967,295. 


4-byte  words  transmitted. 

4-byte  words  received. 

Frames  transmitted. 

Frames  received. 

Class  2  frames  received. 

Class  3  frames  received. 

Link  control  frames  received. 

Multicast  frames  received. 

Multicast  timeouts. 

Multicast  frames  transmitted. 

Time  RRDY  high  priority. 

Time  BB_credit  zero. 

Encoding  errors  inside  frames. 

Frames  with  CRC  errors. 

Frames  shorter  than  minimum. 

Frames  longer  than  maximum. 

Frames  with  bad  end-of-frame. 

Encoding  error  outside  frames. 

Invalid  ordered  set  (platform-  and  port-specific) 

Class  3  frames  discarded  due  to  timeout 
(platform-  and  port-specific). 

er_c3_dest_unreach    Class  3  frames  discarded  due  to  destination 

unreachable  (platform-  and  port-specific). 

Other  discards  (platform-  and  port-specific). 

Class  3  frames  discarded. 

CRC  error  with  good  EOF  (platform-  and 
port-specific). 

Number  of  OPNyx  sent. 

Number  of  OPNyx  received. 

Number  of  OPNfr  sent. 

CLS  sent  due  to  loop  idle. 


stat_wtx 

stat_wrx 

stat_f tx 

stat_f rx 

stat_c2_f rx 

stat_c3_f rx 

stat_lc_rx 

stat_mc_rx 

stat_mc_to 

stat_mc_tx 

t  im  rdv  pr i 

tim_txcrd_z 

er_enc_in 

er_crc 

er_trunc 

er_toolong 

er_bad_eof 

er_enc_out 

er_bad_os 

er  c3  timeout 


er_other_discard 

er_disc_c3 

er_crc_good_eof 

f l_open 
f l_opened 
f l_openf r 
f l_cls_idle 
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f l_cls_rx 
fl_bb_stall 
f l_cf_alloc 
f l_cf_opn 
fl_cf_full 
f l_cf_na 
f l_trig_age 
f l_trig_lp 
open 

transfer 

opened 

starve_stop 
f l_tenancy 
nl_tenancy 
f rame_nozone 


CLS  received  when  OPEN. 

OPN/CLS  BB_Credit  stalls. 

Number  of  CFIFOs  allocated. 

CFIFOs  delivered  when  OPENED. 

Number  of  CFIFOs  full  stalls. 

CFIFO  not  available  stalls. 

Number  of  age  count  triggers. 

Number  of  loop  not  busy  triggers. 

Number  of  times  the  FL_Port  entered  OPEN  state. 

Number  of  times  the  FL_Port  entered  TRANSFER 
state. 

Number  of  times  the  FL_Port  entered  OPENED 
state. 

Loop  tenancies  stopped  due  to  starvation. 
Number  of  times  FL  Port  had  loop  tenancy. 
Number  of  times  NL  Port  had  loop  tenancy. 
Frames  rejected  due  to  zone  protection. 


Operands 


This  command  has  the  following  operands 

slotnumber 


portnumber 


For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  be 
configured,  followed  by  a  slash  (/). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  display  a  list  of  valid  ports. 


Examples 


To  display  the  basic  set  of  statistics  for  a  port: 

switch:user>  portstatsshow  4/15 


stat. 

_wtx 

494 

4-byte  words  transmitted 

stat. 

_wrx 

760 

4-byte  words  received 

stat. 

_ftx 

28 

Frames  transmitted 

stat. 

_f  rx 

32 

Frames  received 

stat. 

_c2_f rx 

0 

Class  2  frames  received 

stat. 

_c3_f rx 

32 

Class  3  frames  received 

stat. 

_lc_rx 

0 

Link  control  frames  received 

stat. 

_mc_rx 

0 

Multicast  frames  received 

stat. 

_mc_to 

0 

Multicast  timeouts 

stat. 

_mc_tx 

0 

Multicast  frames  transmitted 

(continued  on  next  page) 
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starve_stop 

0 

tenancies  stopped  due  to  starvation 

f l_tenancy 

3277 

number  of  times  FL  has  the  tenancy 

nl_tenancy 

11 

number  of  times  NL  has  the  tenancy 

See  also 

portErrShow 
portShow 
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portSwap 


Swaps  area  numbers  of  two  ports. 


Synopsis 

portswap    [slotnumberl/ ] portnumberl    [slotnumber2 I ]portnumber2 

Availability 

admin 

Description 

Use  this  command  to  swap  area  numbers  for  a  pair  of  ports.  Both  ports  must  be  disabled  prior  to 
executing  this  command  and  the  port-swapping  feature  must  be  enabled  using  portSwapEnable. 


NOTE:    To  undo  a  previous  port  swap,  execute  portSwap  again  on  the  same  two  ports. 

portSwap  information  is  kept  in  its  own  database;  it  cannot  be  manipulated  by  editing  the  configuration 
database  displayed  by  conf  igShow  and  conf  igUpload. 


Operands 


This  command  has  the  following  operands: 


portnumber2 


portnumberl 


slotnumberl 


slotnumber2 


For  bladed  systems  only,  specify  the  slot  number  of  the  first  port  whose 
area  number  is  to  be  swapped,  followed  by  a  slash  (/). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems.  Use  switchShow  to  display  a  list  of  valid  ports. 

For  bladed  systems  only,  specify  the  slot  number  of  the  second  port 
whose  area  number  is  to  be  swapped,  followed  by  a  slash  (/). 

Specify  a  port  number  to  be  configured,  relative  to  its  slot  for  bladed 
systems. 


Examples 


To  swaps  area  numbers  between  a  pair  of  ports: 


switch:admin>  portswap  1/e  2/5 


portswap  done 
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See  also 

portDisable 

portEnable 

portShow 

portSwapDi sable 

portSwapEnable 

portSwapShow 

switchShow 
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portSwapDisable 


Disables  the  portswap  feature. 


portswapdi sable 


Availability 

admin 

Description 


Use  this  command  to  disable  the  portswap  feature.  The  portSwap  command  cannot  be  used  after  this 
feature  is  disabled. 

The  enabled  state  of  the  portswap  feature  is  persistent  across  reboots  and  power  cycles. 


NOTE:  Enabling  or  disabling  the  portswap  feature  does  not  effect  previously  performed  portswap 
operations. 


To  disable  the  portswap  feature: 

switch :admin>  portswapdisable 


portDisable 

portEnable 

portShow 

portSwapEnable 

portSwapShow 

switchShow 


Synopsis 


Operands 


none 


Examples 


See  also 
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portSwapEnable 


Enables  the  portswap  feature. 

Synopsis 

portswapenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  portswap  feature.  The  portSwap  command  cannot  be  used  unless  the 
feature  is  first  enabled  with  this  command. 

The  enabled  state  of  the  portswap  feature  is  persistent  across  reboots  and  power  cycles. 

]prf  NOTE:    Enabling  or  disabling  the  portswap  feature  does  not  effect  previously  performed  portswap 
operations. 

Operands 

none 

Examples 

To  enable  the  portswap  feature: 

switch : admin>  portswapenable 

See  also 

portDisable 

portEnable 

portShow 

portSwapDi sable 

portSwapShow 

switchShow 
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portSwapShow 

Displays  the  state  of  the  portswap  feature. 

Synopsis 

portswapshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  state  of  the  portswap  feature,  as  well  as  port  and  area  information  for 
those  ports  whose  area  number  ID  different  from  the  default  area  number.  The  default  area  number  of  a 
port  is  the  same  as  its  switch  port  number. 

Operands 

none 

Examples 


To  display  the  state  of  the  portswap  feature  and 
swapped: 

information  for  ports  whose  area  numbers  have 

switch :admin>  portswapshow 

PortSwap  is  enabled 

Slot         Slotport  Swport 

Area 

2              2  18 

19 

2              3  19 

18 

See  also 

portDisable 

portEnable 

portShow 

portSwap 

portSwapDi sable 

portSwapEnable 

swicchShow 
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portTest 


Performs  a  functional  test  of  a  switch  in  a  live  fabric. 

Synopsis 

porttest  [-ports  itemlist]  [-iteration  count] [-userdelay  time]  [-timeout 
time] [-pattern  pattern]  [-patsize  size]  [-seed  seed]  [-listtype  porttype] 

Availability 

admin 

Description 

Use  this  command  to  isolate  problems  to  a  single  replaceable  element  and  isolate  problems  to  near-end 
terminal  equipment,  far-end  terminal  equipment,  or  the  transmission  line.  Diagnostics  can  be  executed 
every  day  or  on  demand. 

This  command  verifies  the  intended  functional  operation  of  the  switch  by  sending  frames  from  port  M's 
transmitter,  and  looping  the  frames  back  through  an  external  fiber  cable  into  port  M's  receiver,  thus 
exercising  all  the  switch  components  from  the  main  board,  to  the  fiber  cable,  to  the  media  (of  the  devices 
and  the  switch),  and  back  to  the  main  board. 

The  cables  and  media  connected  should  be  of  the  same  technology:  a  short-wavelength  media  (switch) 
port  is  connected  to  another  short-wavelength  media  (device)  port  using  a  short-wavelength  cable;  a 
long-wavelength  port  is  connected  to  a  long-wavelength  port,  and  a  copper  port  is  connected  to  a  copper 
port. 

Only  one  frame  is  transmitted  and  received  at  a  time.  The  port  LEDs  flicker  green  while  the  test  is  running. 
The  following  port  types  are  supported: 

•  E_Ports 

•  F_Ports  (must  support  ELS  ECHO) 

•  L_Ports 

•  N->N  loopback  ports 

This  command  will  not  run  on  any  other  port  type. 
The  command  performs  the  following  actions: 

Initiate  tests  on  certain  ports  (portTest  command). 

2.  Stop  active  tests  on  certain  ports  (stopPortTest  command). 

3.  Get  the  snapshot  of  the  test  result  (portTestShow  command). 

Once  portTest  is  triggered,  you  can  use  stopPortTest  to  stop  the  test.  See  the  stopPortTest 
command  for  more  information. 

View  the  current  progress  of  portTest  by  running  portTestShow.  See  the  portTestShow  command 
for  more  information. 

If  there  is  a  port  type  change  during  portTest  execution,  the  test  will  continue  on  a  given  port  as  long 
as  it  can  be  supported  and  it  is  asked  to  do  so.  If  a  request  was  made  to  test  all  possible  ports  on  a  given 
switch,  portTest  will  start  a  new  test  using  the  new  port  type  to  start  a  appropriate  test. 
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Operands 

This  command  has  the  following  operands: 

-ports  itemlist  Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports 

in  the  switch  are  tested.  See  the  itemList  help  pages  for 
further  details. 

-iteration  count  Specify  the  number  of  times  (or  number  of  frames  per  port)  to 

execute  this  test.  The  default  value  is  20.  Valid  values  include: 

0  Run  the  test  on  timeout  mode. 

■1  Run  indefinitely. 

-userdelay  time  Specify  the  delay  between  frames  sent  by  portTest,  in 

milliseconds.  The  default  value  is  10  milliseconds. 

-timeout  time  Specify  the  number  of  seconds  to  run  the  test.  Setting  the 

iteration  to  0  will  set  the  portTest  into  timeout  mode.  The 
default  value  is  0. 

-pattern  Specify  the  pattern  of  the  test  packets  payload.  Twenty  types 

of  predefined  patterns  are  provided  with  the  test.  Use  the 
dataTypeShow  command  to  view  the  types  of  patterns  that 
are  supported  with  portTest.  dataTypeShow  displays  the 
pattern  names,  the  number  to  use  to  specify  for  each  pattern 
type,  and  an  example  of  each  pattern.  The  default  pattern 
type,  if  no  pattern  number  is  specified,  is  RANDOM 
(type=ll). 

-patsize  size  Specify  the  size  of  the  pattern.  The  default  size  of  the  pattern 

is  1 024  bytes.  Valid  range  of  values  are  4  bytes  through 
2112  bytes. 

-seed  seed  Specify  the  seed  pattern  to  be  used  with  pattern.  The  default 

seed  value  is  Oxaa. 

-listtype  porttype  Specify  the  type  of  ports  to  run  portTest.  The  default 

following  values  are  predefined  for  porttype: 

■1  All  ports 

■2  All  L_Ports 

■3  All  F_Ports 

■4  All  E_Ports 

■5  All  N->N  loopback  ports 

The  default  value  is  -1 . 

Examples 

To  run  a  functional  test  on  an  active  switch: 


switch :admin>  porttest  -ports  1/1-1/3 


See  also 


cross PortTest 

fportTest 

loopPortTest 

portLoopbackTest 

portTestShow 

spinFab 

stopPortTest 
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portTestShow 


Displays  information  from  portTest. 


Synopsis 

porttestshow   [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  display  a  snapshot  of  information  from  portTest.  The  following  information 
appears: 

Pass  or  fail  information  on  a  given  port 
Port  type  tested 

Current  state  of  portTest  (NO  TEST,  TESTING,  or  TEST  DONE) 

Type  of  ports  asked  to  test  (ALLPORTS,  ALL_E  PORTS,  ALL  L  PORTS,  ALL  F  PORTS,  ALL  LB  PORTS, 
or  SINGLE_PORT) 

Pattern  used  in  testing 

Seed  used  in  testing 

User  delay  value 

Total  iteration  asked  to  test 

Current  test  iteration 

Total  fails  on  this  test 

Consecutive  fails  on  this  test 

portTest  start  time 

portTest  stop  time 

Timeout  value 

Error  code  if  any 


Operands 


The  following  operands  are  required: 

-ports  itemlist         Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in 

the  current  slot  will  be  assumed.  See  itemList  help  pages  for 
further  details. 
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Examples 

To  display  information  from  portTest: 


switch : admin>  porttestshow  1 

Port  1    :  PASS 

PortType :  OTHER 

PortState:  NO  TEST 

PortlnternalState :  INIT 

PortTypeToTest :  NO_TEST 

Pattern:   0x0  Seed: 

0x0                        UserDelay:  0 

Totallteration :  0 

Currentlteration :  0 

TotalFail:  0 

ConsecutiveFail :  0 

StartTime:  NONE 

StopTime:  NONE 

Timeout :  0 

ErrorCode :  0 

See  also 

cross PortTest 

fportTest 

itemList 

loopPortTest 

portLoopbackTest 

portTest 

spinFab 

stopPortTest 
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powerOffListSet 


Sets  slot  power-off  list  order. 

Synopsis 

powerof f listset 

Availability 

admin 


Description 

Use  this  command  to  change  the  order  in  which  slots  are  powered  off.  This  command  displays  the  current 
order  and  then  prompts  you  to  indicate  the  new  order. 

Whenever  a  power  supply  goes  out  of  service  or  a  field-replaceable  unit  (FRU)  is  inserted,  the  system 
available  power  is  compared  to  the  system  required  power  to  determine  if  there  is  enough  power  to 
operate.  If  there  is  less  power  available  than  the  demand,  the  power-off  list  is  processed  until  there  is 
enough  power  for  the  system  to  operate. 

If  the  system  abruptly  goes  from  a  state  in  which  there  is  enough  power  to  run  all  inserted  and  powered 
on  FRUs  to  a  state  in  which  there  is  not  enough  power  to  run  everything  (for  instance,  when  suddenly  only 
one  power  supply  is  available  to  power  a  fully  loaded  system),  no  processing  of  the  power-off  list  can  be 
done.  This  is  because  the  lack  of  power  causes  the  CP  boards'  processors  to  cease  execution  of  the 
firmware.  In  this  situation,  all  operation  of  the  system  terminates  immediately.  However,  if  the  system  is 
running  on  two  power  supplies  (this  is  not  recommended)  and  one  goes  into  a  predicted  fail  state  (in 
which  the  power  supply  is  still  supplying  power),  the  power-off  list  is  processed  as  described. 

The  power-off  list  affects  only  the  order  in  which  slots  are  powered  off.  On  power  up  or  when  an 
additional  power  supply  is  added,  slots  are  processed  to  verify  that  they  can  be  powered  up.  This 
processing  always  starts  at  slot  1  and  proceeds  to  the  last  slot  in  the  chassis.  Also,  other  FRUs  in  the 
chassis  might  use  significant  power,  yet  they  cannot  be  powered  off  by  software.  For  example,  a  missing 
blower  FRU  might  change  the  power  computation  enough  to  affect  how  many  slot  blades  can  be 
powered  up. 

The  format  of  the  display  varies,  depending  on  the  switch  model  and  the  number  of  slots  present. 
Operands 

none 
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Examples 


To  modify  the  power-off  list  order: 


switch : admin>  powerof f listSet 

Slot 

Current  POL 

10 

1st 

9 

2nd 

8 

3rd 

7 

4  th 

4 

5  th 

3 

6  th 

2 

7  th 

1 

8  th 

1st 

slot  to  be  powered  off:  (1. 

.  10) 

[10]  1 

2nd 

slot  to  be  powered  off:  (2. 

.10) 

[9]  2 

(continued  on  next  page) 

3rd 

slot 

to 

be 

powered 

off: 

(3  . 

10) 

[8] 

3 

4  th 

slot 

to 

be 

powered 

off: 

(4. 

10) 

[7] 

4 

5  th 

slot 

to 

be 

powered 

Off: 

(7. 

10) 

[7] 

10 

6  th 

slot 

to 

be 

powered 

Off: 

(7. 

9) 

[8] 

9 

7  th 

slot 

to 

be 

powered 

Off: 

(7. 

8) 

[8] 

8 

8  th 

slot 

to 

be 

powered 

Off: 

(7. 

7) 

[7] 

7 

Old 

POL 

New 

POL  Power 

Off 

Order 

10 

1 

1st 

9 

2 

2nd 

8 

3 

3rd 

7 

4 

4  th 

4 

10 

5  th 

3 

9 

6  th 

2 

8 

7  th 

1 

7 

8  th 

Proceed  to  change  the  POL  order?    (yes,  y,   no,   n) :    [no]  y 


See  also 


chassisShow 
powerOf f Li st Show 
psShow 


Fabric  OS  5.x  command  reference  guide  531 


slotPowerOf f 

slotPowerOn 

slotShow 
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powerOffListShow 

Displays  slot  power-off  list  order. 

Synopsis 

power of f listshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  order  in  which  the  physical  slots  will  be  powered  off.  The 
system-available  power  is  compared  to  the  system  demand  power  to  determine  if  there  is  enough  power 
to  operate.  If  there  is  less  power  available  than  the  demand,  then  the  power-off  list  is  processed  until  there 
is  enough  power  for  the  system  to  operate. 

If  the  system  abruptly  goes  from  a  state  in  which  there  is  enough  power  to  run  all  inserted  and  powered 
on  FRUs  to  a  state  in  which  there  is  not  enough  power  to  run  everything  (for  instance,  when  a  third  power 
supply  is  removed  from  the  chassis  so  there  is  suddenly  only  one  power  supply  is  available  to  power  a 
fully  loaded  system),  no  processing  of  the  power-off  list  can  be  done.  This  is  because  the  lack  of  power 
causes  the  CP  boards'  processors  to  cease  execution  of  the  firmware.  In  this  situation,  all  operation  of  the 
system  terminates  immediately.  However,  if  the  system  is  running  on  two  power  supplies  (this  is  not 
recommended)  and  one  goes  into  a  predicted  fail  state  (in  which  the  power  supply  is  still  supplying 
power),  the  power-off  list  is  processed  as  described. 

The  format  of  the  display  varies,  depending  on  the  switch  model  and  the  number  of  slots  present. 
Operands 

none 

Examples 

To  display  the  slot  power-off  list  order: 

switch :admin>  powerOffListShow 


Slot 

10 

will 

be 

powered 

off 

1st 

Slot 

9 

will 

be 

powered 

off 

2nd 

Slot 

8 

will 

be 

powered 

off 

3rd 

Slot 

7 

will 

be 

powered 

off 

4th 

Slot 

6 

will 

be 

powered 

off 

5th 

Slot 

5 

will 

be 

powered 

off 

6  th 

Slot 

4 

will 

be 

powered 

off 

7  th 

Slot 

3 

will 

be 

powered 

off 

8th 

Slot 

2 

will 

be 

powered 

off 

9  th 

Slot 

1 

will 

be 

powered 

off 

10th 
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See  also 

chassisShow 
powerOff List Show 
psShow 
slotPowerOf f 
slotPowerOn 
slotShow 
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psShow 

Displays  power  supply  status. 

Synopsis 

psshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  status  of  the  switch  power  supplies. 
The  status  of  each  supply  is  displayed  as: 


OK  Power  supply  functioning  correctly 

absent  Power  supply  not  present 

unknown  Unknown  power  supply  unit  installed 

predicting  failure  Power  supply  is  present  but  predicting  failure 

faulty  Power  supply  present  but  faulty  (no  power  cable,  power  switch 


turned  off,  fuse  blown,  or  other  internal  error) 
For  certain  switch  models,  the  OEM  serial  ID  data  appears  after  each  power  supply  status  line. 

Operands 

none 

Examples 

To  view  the  status  of  the  power  supply  for  an  HP  StorageWorks  Core  Switch  2/64: 


switch :admin>  psShow 

Power  Supply  #1  is  OK 

DELTA  DPS-1001AB-1E  23000000601 

SI 

IXD0111000088 

Power  Supply  #2  is  faulty 

DELTA  DPS-1001AB-1E  23000000601 

SI 

IXD0111000162 

Power  Supply  #3  is  OK 

DELTA  DPS-1001AB-1E  23000000601 

SI 

IXD0111000120 

Power  Supply  #4  is  absent 

To  view  the  status  of  the  power  supply  for  an  HP  StorageWorks  SAN  Switch  2/32  switch: 


switch : admin>  psShow 

Power  Supply  #1  is  faulty 

013  5, FF000000088, 60-000073  9 

-01, 

A, 00001, SP4  67, 1A, FF000000088 

Power  Supply  #2  is  OK 

013  5, FFO00 00 0089, 60-0000739 

-01, 

A,  00001,  SP4  67, 1A, FF000000089 
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See  also 

chassisShow 
f anShow 
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q  loop  Add 

Adds  a  member  to  a  QuickLoop. 

Synopsis 

qloopadd  " qloopname"  ,    " member ; member" 

Availability 

admin 


r2^f  NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
b— I    Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  QuickLoop. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  one  or  two 
switch  worldwide  names. 

Zone  alias  names  entered  as  members  of  this  QuickLoop  must  be  defined  with  WWNs.  Zone  alias  names 
that  are  defined  by  domain  and  port  number,  or  AL  PA  are  not  accepted  as  members  of  the  QuickLoop. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Use  this  command  only  with  Fabric  OS  3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  Fabric 
OS  5.x. 


Operands 

The  following  operands  are  required: 

qloopname  Specify  the  name  of  the  QuickLoop,  in  quotation  marks. 

member  Specify  a  list  of  QuickLoop  members,  in  quotation  marks, 

separated  by  semicolons.  Include  one  or  more  of  the  following: 

*  world  wide  names 

•  Zone  alias  names 

Examples 

To  add  an  alias  for  a  second  WWN  to  "qlpl ": 

switch : admin>  qloopAdd  "qlpl",  "wwn2" 

See  also 

qloopCreate 
qloopDelete 
qloopRemove 
qloopShow 
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qloopCreate 


Creates  a  QuickLoop. 


Synopsis 


gloopcreate  "qloopname" ,   " member ; member 


Availability 


admin 


\^)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 


Use  this  command  to  create  a  QuickLoop. 

A  QuickLoop  name  must  begin  with  a  letter  and  be  followed  by  any  number  of  letters,  digits,  and 
underscore  characters.  Names  are  case-sensitive,  for  example,  Qloop_l  indicates  a  different  QuickLoop 
than  qloop_l .  Spaces  are  ignored. 

The  QuickLoop  member  list  must  have  one  or  two  members;  an  empty  list  is  not  allowed. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  a  maximum 
of  two  switch  worldwide  names. 

Zone  alias  names  entered  as  members  of  this  QuickLoop  must  be  defined  with  WWNs.  Zone  alias  names 
that  are  defined  by  domain  and  port  number,  or  AL_PA  are  not  accepted  as  members  of  the  QuickLoop. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Use  this  command  only  with  Fabric  OS  3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  Fabric 


Description 


OS  5.x. 


Operands 


The  following  operands  are  required: 


member 


qloopname 


Specify  the  name  of  the  QuickLoop  to  be  created,  in  quotation 
marks,  qloopname  cannot  be  used  for  another  zone  object. 

Specify  a  list  of  members  to  be  added  to  the  QuickLoop,  in 
quotation  marks,  separated  by  semicolons.  Include  one  or  more 
of  the  following: 

•    world  wide  names 


Zone  alias  names 
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Examples 

To  create  two  QuickLoops,  a  single  switch  and  one  dual  switch: 


switch; 

: admin> 

qloopCreate 

"qlpl", 

"10 : 00 

: 00 : 60 : 69 : 00 : 60 : 11" 

switch: 

: admin> 

qloopCreate 

"qlp2", 

" wwn2 ; 

wwn3  " 

See  also 

qloopAdd 

qloopDelete 

qloopRemove 
qloopShow 
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qloopDelete 


Deletes  a  QuickLoop. 

Synopsis 

qloopdelete  "name 

Availability 

admin 


NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  delete  a  QuickLoop. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  non-volatile  memory  using  the  cf  gSave  command.  For  the  change  to  become 
effective,  an  appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Use  this  command  only  with  Fabric  OS  3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  Fabric 
OS  5.x. 


Operands 

The  following  operand  is  required: 

name  Specify  the  name  of  the  QuickLoop,  in  quotation  marks.  This 

operand  is  required. 

Examples 

To  delete  QuickLoop  "qloop2": 

switch: admin>  qloopDelete  "qloop2" 

See  also 

qloopAdd 

qloopCreate 
qloopRemove 
qloopShow 
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q  loop  Remove 

Removes  a  member  from  a  QuickLoop. 

Synopsis 


qloopremove  " qloopName"  ,   " member ; member" 


Availability 

admin 


NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  remove  one  or  more  members  from  a  QuickLoop. 

The  member  list  is  identified  through  an  exact  string  match;  therefore,  when  removing  multiple  members, 
order  is  important.  For  example,  if  a  QuickLoop  contains  "wwn3;  wwn4",  removing  "wwn3;  wwn4" 
succeeds,  but  removing  "wwn4;  wwn3"  fails. 

If  all  members  are  removed,  the  QuickLoop  is  deleted. 

When  a  configuration  is  enabled,  all  QuickLoops  defined  in  the  configuration  must  resolve  to  one  or  two 
switch  worldwide  names. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  non-volatile  memory  using  the  cf  gSave  command.  For  the  change  to  become 
effective,  an  appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

"22^>  NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Use  this  command  only  with  Fabric  OS  3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  Fabric 
OS  5.x. 


Operands 

The  following  operands  are  required: 

qloopName  Specify  the  name  of  the  QuickLoop,  in  quotation  marks. 

member  Specify  the  list  of  the  QuickLoop  members  to  be  removed,  in 

quotation  marks,  separated  by  semicolons.  Include  one  or  more 
of  the  following: 

*  world  wide  names 

•  Zone  alias  names 

Examples 

To  remove  member  "wwn2"  from  "qlpl  ": 

switch : admin>  qloopRemove  "qlpl",  "wwn2" 
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See  also 

qloopAdd 

qloopCreate 
qloopDelete 
qloopShow 
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qloopShow 

Displays  QuickLoop  information. 

Synopsis 

qloopshow   [pattern]  [,  mode] 

Availability 

all  users 


NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  display  QuickLoop  configuration  information. 

If  no  parameters  are  specified,  all  zone  configuration  information  (defined  and  enabled)  is  displayed. 
See  cfgShow  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  QuickLoop  names;  those  that  match  in  the 
defined  configuration  are  displayed. 

This  command  changes  the  Defined  Configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:    When  security  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Use  this  command  only  with  Fabric  OS  3.x  systems  in  the  fabric;  QuickLoop  is  not  supported  in  Fabric 
OS  5.x. 


Operands 

The  following  operands  re  optional: 

pattern  Specify  a  POSIX-style  expression  used  to  match  QuickLoop 

names.  Patterns  can  contain  the  following  special  characters: 

•  Question  mark  "?",  which  matches  any  single  character 

•  Asterisk  "*",  which  matches  any  string  of  characters 

•  Ranges  "[0-9a-f]",  which  match  any  character  within  the 
range 

mode  Specify  1  to  display  the  contents  of  RAM;  specify  0  to  display 

the  contents  of  the  transaction  buffer.  The  default  value  is  0. 
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Examples 

To  display  all  QuickLoops  beginning  with  the  letter  "q": 


switch: 

: admin> 

qloopshow  "q*" 

qloop : 

qlpl 

10:00:00: 

:60: 

:  69  : 

:00: 

:60: 

:11 

10:00:00: 

:60: 

:  69  : 

:00: 

:30  : 

:  02 

qloop : 

i  qlp2 

10:00:00: 

:60: 

:  69  : 

:00: 

:60: 

:13 

See  also 

qloopAdd 

qloopCreate 
qloopDelete 
qloopRemove 
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quietMode 

Sets  or  clears  the  telnet  session  quiet  mode,  or  displays  the  current  mode. 

Synopsis 

quietmode  [mode] 

Availability 

admin 

Description 

This  command  affects  the  output  displayed  on  the  switch  console  (telnet  session  only). 

By  default,  quiet  mode  is  off  and  all  switch  tasks  can  send  output  to  the  console.  Some  output  is  caused 
by  asynchronous  events,  such  as  the  fabric  reconfiguring  or  devices  logging  in. 

When  quiet  mode  is  on,  only  output  produced  by  shell  commands  displays;  all  asynchronous  output 
produced  by  other  tasks  suppresses.  This  is  useful  when  driving  a  telnet  session  through  a  script  that  might 
not  expect  any  asynchronous  output. 

Operands 

The  following  operand  is  optional: 

mode  0  clears  quiet  mode  and  all  tasks  appear  to  the  console;  1  sets 

quiet  mode  and  only  shell  commands  appear. 

The  current  value  appears  if  no  operand  is  specified. 

Examples 

To  display  the  current  mode  and  then  set  it  to  off: 

switch : admin>  quietMode 
quietMode:  On 


Usage:  quietMode  0[l 
0:   to  turn  it  off 
1:   to  turn  it  on 


switch : admin>  quietMode  0 
Committing  configuration ...  done 
Quiet  Mode  is  now  OFF 


See  also 

none 
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rcsDisabled 

Displays  whether  Reliable  Commit  Service  (RCS)  is  enabled. 

Synopsis 

rcsdisabled 

Availability 

all  users 

Description 

Use  this  command  to  display  whether  RCS  is  enabled. 

If  rcsDisabled  =  0  appears,  RCS  is  enabled;  rcsDisabled  =  1  appears  if  RCS  is  disabled. 

[2^>  NOTE:    This  command  can  be  issued  on  Fabric  OS  v4.1  .x,  and  above,  and  v5.x  FCS  switch  in  the 
fabric. 


Operands 

none 

Examples 

To  display  the  RCS  status: 

switch : admin>  rcsDisabled 

rcsDisabled  =  0 

See  also 

none 
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reboot 

Reboots  either  one  control  processor  (CP)  or  the  entire  system. 

Synopsis 

reboot 

Availability 

admin 

Description 

Use  this  command  to  immediately  reboot  a  CP  in  a  director  or  an  entire  switch.  The  command  line  session 
is  closed. 

When  this  command  is  issued  on  a  single-CP  system,  all  switches  in  the  system  are  entirely  shut  down  and 
all  Fibre  Channel  ports  become  inactive  until  the  system  restarts.  When  this  command  is  issued  on  the 
active  CP  of  a  dual-CP  system,  the  active  CP  reboots,  the  standby  CP  takes  over  as  the  active  CP,  and  all 
Fibre  Channel  ports  become  inactive  until  the  new  active  CP  reinitializes  these  ports. 

If  this  switch  is  part  of  a  fabric,  reboot  the  switch  so  that  the  remaining  switchesare  reconfigured. 

Operands 

none 

Examples 

To  reboot  the  CP: 

switch : admin>  reboot 
Rebooting . . . 


See  also 

f astBoot 
switchReboot 
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routeHelp 

Displays  a  list  of  FSPF-related  commands. 

Synopsis 

routehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  FSPF-related  commands. 

Operands 

none 

Examples 


To  display  a  list  of  FSPF 

related  commands: 

switch : admin>  routehelp 

aptPolicy 

Get  or  set  Advanced  Performance  Tuning  policy 

bcastShow 

Print  broadcast  tree  information 

dlsReset 

Turn  off  Dynamic  Load  Sharing 

dlsSet 

Turn  on  Dynamic  Load  Sharing 

dlsShow 

Print   state  of  Dynamic  Load  Sharing 

f spf Show 

Print  FSPF  global  information 

inter face Show 

Print  FSPF  interface  information 

iodReset 

Turn  off  In-Order  Delivery 

iodSet 

Turn  on  In-Order  Delivery 

iodShow 

Print  state  of  In-Order  Delivery 

linkCost 

Set  or  print  the  FSPF  cost  of  a  link 

LSDbShow 

Print  Link  State  Database  entry 

nbrStateShow 

Print  neighbor's   summary  information 

nbrStatsClear 

Reset  FSPF  neighbor's  counters 

topologyShow 

Print  paths  to  domain (s) 

uRouteConf ig 

Configure  static  unicast  route 

uRouteRemove 

Remove  static  unicast  route 

uRouteShow 

Print  port's  unicast   routing  info 

See  also 

bcastShow 
interf aceShow 
uRouteShow 
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saveCore 


Saves  or  removes  core  files  created  by  daemons. 


Synopsis 


To  FTP  core  files: 

savecore  [[-f  core- file-list] ...  |  ]  [-h  ip-address]  [-u  user_name  |  -a]  [-p 
password]  [-d  remote_directory] 

To  remove  core  files: 

savecore   [ [-r  core- files-directory-list] ...    |  ] 
To  list  core  files: 

savecore  -1 


Availability 


admin 


Description 


Use  this  command  to  FTP  core  files,  to  remove  core  files,  or  to  list  core  files.  With  no  arguments, 
saveCore  enters  interactive  mode. 


Options 


This  command  has  the  following  options: 


-h  ip-address 


Specify  a  host  name  if  FTP  requires  it. 


-u  user_name 


p  password 


Specify  a  user  name  for  the  host  name;  default  is 
anonymous. 

Specify  a  password  for  the  user  name. 


-1 


-a 


-R 


-f  core- file-directory-list 


d  remote_directory 


r  core- files-directory-list 
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Examples 

To  list  all  core  files  in  a  CP: 


switch : admin>  savecore  -1 
/core_f iles/panic/core . 873 
/core_f iles/zoned/core .1234 
/core_f iles/ zoned/ core .5678 
/mnt/core_f iles/nsd/core . 873 
/mnt/core_f iles/panic/core . 873 

To  remove  selected  core  files  from  a  CP: 

switch : admin>  savecore  -r 

/core_f iles/panic/ , /core_f iles/zoned/ , /mnt/core_f iles/nsd/ 


Removing : 

/core_f iles/panic/ 

Removing : 

/core_f iles/zoned/ 

Removing : 

/mnt/core_f iles/nsd/ 

To  remove  selected  core  files  from  the  CP  (using  multiple  -r  operands): 

switch: admin>  savecore  -r  /core_f iles/panic/  -r 
/core_f iles/zoned/ , /mnt/core_f iles 

/nsd/ 

Removing : 

/core_f iles/panic/ 

Removing : 

/core_f iles/zoned/ 

Removing : 

/mnt/core_f iles/nsd/ 

To  remove  all  core  files: 


switch : admin>  savecore  -R 
removing  core  files  under 
removing  core  files  under 
removing  core  files  under 
removing  core  files  under 


To  FTP  all  core  files: 


switch : admin>    savecore  -h  192.168.204.188 
-p  fexosophy  -F 

-u  j smith  - 

d  core. 

_f  iles_here 

/core_f iles/panic/core . 873 : 

1 . 12 

kB 

3E 

11 

87  B/s 

/core_f iles/zoned/core . 12  34 : 

1 . 12 

kB 

3? 

!2 

14  B/s 

/core_f iles/zoned/core . 5678 : 

1.12 

kB 

35 

S2 

50  B/s 

/mnt/core_f iles/nsd/core . 873 : 

1.12 

kB 

3E 

11 

93  B/s 

/mnt/core_f iles/panic/core . 873 : 

1 . 12 

kB 

3E 

11 

90  B/s 

Files  transferred  successfully! 
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/core_f iles/panic 
/core_f iles/zoned 
/mnt/core_f iles/nsd 
/mnt/core_f iles/panic 


To  FTP  selected  core  file  directories: 


switch : admin>  savecore  -h  192.16 
-p  password 

8.204.188  -u 

j smith  -d  core. 

_f iles_here 

-f  /core_f iles/zoned/ , /mnt/core_ 

f iles/nsd/ 

/core_f iles/ zoned/ /core . 1234 : 

1.12  kB  3! 

32.60  B/s 

/core_f iles/zoned//core. 5678  : 

1.12  kB  3! 

31.95  B/s 

/mnt/core_f iles /nsd/ /core . 873  : 

1.12  kB  3i 

32.53  B/s 

Files  transferred  successfully! 

To  remove  all  core  files  using  the  savecore  management  utility: 


switch : admin>  savecore 

following  1  directories  contains  core  files: 
[   ]0:    /mnt/core_f iles/panic 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

U)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice :  1 

/mnt/core_f iles/panic 

You  have  opted  to  remove  ALL  core  files :- 
Please  confirm  (Y/ [N] ) :  y 
Removing  files  .... 

removing  core  files  under:  /mnt/core_f iles/panic 
Done ! 

switch : admin> 

switch : admin>  savecore 

No  core  files  found! 
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To  FTP  core  files  using  the  savecore  management  utility: 


switch : admin>  savecore 

following  1  directories  contains  core  files: 
[   ]0:    /core_f iles/zoned 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

u)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice:  F 
/core_f iles/zoned 

You  have  opted  to  FTP  these  core  files :- 
Please  confirm  (Y/ [N] ) :  y 
Destination  IP  Address?  192.168.10.10 
User  Name   [anonymous]?  jsmith 
Remote  Directory  [ . ] ?  bred 
Password:  ********** 

/core_f iles/zoned/core . 8323 :  1.12  kB     382.40  B/s 

Files  transferred  successfully! 
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To  remove  core  files  from  a  selected  directory: 


switch : admin>  savecore 

following  2  directories  contains  core  files: 
[  ]0:   /core_f iles/nsd 
[  ]1:   /core_f iles/zoned 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

U)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice :  m 

Enter  File  Number  to  mark:  1 

Enter  CR  To  Continue. . . . 

following  2  directories  contains  core  files: 
[  ]0:   /core_f iles/nsd 
[*]1:   /core_f iles/zoned 

Welcome  to  core  files  management  utility. 


Menu 

1  (or 

R)  : 

Remove  all  core  files 

2  (or 

F)  : 

FTP  all  core  files 

3  (or 

r)  : 

Remove  marked  files 

4  (or 

f )  : 

FTP  marked  files 

5  (or 

m)  : 

Mark  Files  for  action 

6  (or 

U)  : 

Un  Mark  Files  for  action 

9  (or 

e)  : 

Exit 

Your  choice :  r 

/core_f iles/zoned 

You  have  opted  to  remove  core  files  under  these 

directories : - 

Please  confirm  (Y/ [N] ) :  y 

Removing  files  .... 

removing  core  files  under:    /core_f iles/zoned 
Done ! 


Fabric  OS  5.x  command  reference  guide  553 


See  also 

none 
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secActiveSize 


Displays  the  size  of  the  active  security  database. 


Synopsis 


secactivesize 


Availability 


admin 


Description 


Use  this  command  to  display  the  size  of  the  active  security  database. 
The  maximum  is  256  KB. 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff.  The  information 
displayed  might  not  be  supported  between  releases  and  is  subject  to  change  arbitrarily. 

[—)f  NOTE:   This  command  must  be  issued  in  secure  mode. 


Operands 


none 


Examples 


To  display  the  size  of  the  active  security  database: 


switch : admin>  secactivesize 


Size  of  security  active  data:   35  bytes    (Max  262144  bytes) 


See  also 


secDef ineSize 


secGlobalShow 
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secAuthSecret 


Manages  the  DH-CHAP  shared  secret  key  information. 

Synopsis 

secauthsecret   [--show] [--set] [--remove  value   |  --all] 

Availability 

admin 

Description 

Use  this  command  to  manage  the  DH-CHAP  shared  secret  key  database  used  for  the  authentication.  This 
command  displays,  sets,  and  removes  shared  secret  key  information  from  the  database  or  deletes  the 
entire  database.  If  you  are  performing  set  or  remove  operations,  when  the  command  is  completed  new 
data  is  saved  persistently.  New  data  is  effective  with  the  next  authentication  request.  The  configuration 
applies  to  a  switch  instance  only. 


NOTE:   A  security  license  is  required  to  run  this  command  in  nonsecure  as  well  as  secure  mode. 


Operands 

The  operands  are  as  follows: 

--show  Lists  the  WWNs  to  which  shared  secret  is 

configured. 

--set  Sets  shared  secrets  with  a  WWN. 

--remove  [wwn  |   domain  |   sw  name]     Removes  the  specified  WWN  entry  from  the 

database.  If  a  domain  name  is  specified,  it  is 
converted  to  WWN  and  then  the  entry  is 
removed.  If  no  option  is  specified,  command 
is  interactive. 

--remove  --all  Deletes  the  entire  secret  key  database. 

Without  any  specified  operands,  the 
command  displays  the  usage. 

Examples 

To  list  the  shared  secret  WWN: 

switch: admin>  secauthsecret  --show 
WWN  Did  Name 


10:00:00:60:69:80:5b:e8         1  switch 
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To  set  the  shared  secret: 


switch :admin>  secAuthSecret  --set 

This  command  sets  up  secret  keys  for  the  DH-CHAP 

authentication.   The  minimum  length  of  a  secret  key  is  8 

characters  and  maximum  40  characters.   Setting  up  secret  keys 

does  not  initiate  DH-CHAP  authentication.   If  switch  is 

configured  to  do  DH-CHAP,   it  is  performed  whenever  a  port 

or 

a  switch  is  enabled. 

Warning:  Please  use  a  secure  channel  for  setting  secrets. 

Using 

an  insecure  channel  is  not  safe  and  can  compromise  secrets. 

Following  inputs  should  be  specified  for  each  entry. 

1.  WWN  for  which  secret  is  being  set  up. 

2.  Peer  secret:  The  secret  of  the  peer  that  authenticates 

to  peer. 

3.  Local  secret:  The  local  secret  that  authenticates  peer. 

Press  Enter  to  start  setting  up  shared  secrets  > 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) : 
10:00:00:60:69:80 

:05:14 

Enter  peer  secret: 

Re-enter  peer  secret: 

Enter  local  secret: 

Re-enter  local  secret: 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) : 

Are  you  done?    (yes,  y,   no,   n) :    [no]  y 

Saving  data  to  key  store...  Done. 
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To  remove  a  shared  secret  WWN: 


switch: admin>  secAuthSecret  --remove 

This  command  deletes  database  of  DH-CHAP  secret  keys.  If 

a  fabric 

requires  authentication,  deleting  this  database  may  cause 

switch 

to  segment  from  the  fabric . 

Re-enter  peer  secret: 

Enter  local  secret: 

Re-enter  local  secret : 

Enter  WWN,   Domain,   or  switch  name   (Leave  blank  when  done) 

Are  you  done?    (yes,   y,   no,   n) :    [no]  y 

Saving  data  to  key  store...  Done. 

To  delete  the  entire  secret  key  database: 


switch : admin>  secAuthSecret  --remove  --all 

This  command  deletes  database  of  DH-CHAP  secret 

keys.   If  a  fabric 

requires  authentication,  deleting  this  database 

may  cause  switch 

to  segment  from  the  fabric . 

Do  want  to  remove  secret  key  database?   (yes,  y, 

no,   n)  :    [no]  y 

Deleting  secret  key  database...  Done. 

See  also 

none 
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secCertUtil 

A  utility  that  manages  third-party  PKI-based  certificates  in  the  switch. 

Synopsis 

seccertutil 

Availability 

admin 

Description 

Use  this  command  to  manage  third-party  certificates  in  the  switch,  as  follows: 

•  Generate  a  public/private  key  pair. 

•  Generate  a  certificate  signing  request  (CSR). 

•  Delete  a  CSR. 

•  List  the  certificates  present  in  the  switch. 

•  Display  the  contents  of  a  certificate/CSR. 

•  Delete  a  specific  certificate. 

•  Configure  a  SSL  certificate  file  name. 
Enable  secure  protocols. 

The  following  is  the  usage  statement  for  the  utility: 

seccertutil  delcsr  Delete  CSR 

seccertutil  delete  file  name     Delete  certificate 
seccertutil  export  Export  CSR 

seccertutil  genkey  Generate  a  new  public/private  key  pair 

seccertutil  gencsr  Generate  a  new  CSR 

seccertutil  import   [-config  cacert]    |    [-config  swcert   [-enable  https] ] 

import 

-config  swcert  Configure  SSL  certificate  filename  (optional) 
-config  cacert  Configure  CA  certificate  filename  (optional) 
-enable  https        Enable  secure  https  (optional) 

seccertutil  showcsr  Display  CSR  contents 

seccertutil  show  List  certificate 

seccertutil  show  filename  Display  certificate  content 


Fabric  OS  5.x  command  reference  guide  559 


Operands 

The  operands  are  as  follows: 


delete  certificate_name 


genkey 


gencsr 


delcsr 


export 


showcsr 


show  certificate_name 


show 


import     [-config  cacert]    |    [-config  swcert    [-enable  https] ] 
Import  a  certificate  on  to  the  switch.  Use  this  for  the  following: 

•  Download  a  certificate  issued  by  a  CA  after  sending  the  CSR  to  the  CA. 

*  Download  an  Issuing  CA  certificate. 

*  Set  imported  certificate  with  -config  option.  Specifying  cacert  sets  the  CA  certificate  file  name  in 
configuration  and  specifying  swcert  sets  switch  certificate  file  name  in  configuration. 

•  Enable  secure  protocols  with  -enable  option.  This  option  can  be  used  only  with  -config  swcert. 


To  generate  a  public/private  key  pair: 

switch : admin>  seccertutil  genkey 

Generating  a  new  key  pair  will  automatically  do  the  following: 

1.  Delete  all  existing  CSRs . 

2.  Delete  all  existing  certificates. 

3.  Reset  the  certificate  filename  to  none. 

4.  Disable  secure  protocols. 

Continue   (yes,   y,   no,   n) :    [no]  y 
Select  key  size   [1024  or  2048]  : 
Generating  new  rsa  public/private  key  pair 
Done . 


Examples 
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To  generate  a  CSR: 


switch : admin>  seccertutil  gencsr 
Country  Name   (2  letter  code,   eg,   US) : 
State  or  Province  Name  (full  name,   eg,  California): 
Locality  Name   (eg,   city  name)  : 
Organization  Name   (eg,   company  name) : 

Organizational  Unit  Name   (eg,   department  or  section  name) : 
Common  Name   (Fully  qualified  Domain  Name,   or  IP  address) : 
generating  CSR,    file  name  is:   <ip_address> . csr 
Done 

To  delete  the  CSR: 

switch:admin>  seccertutil  delcsr 
WARNING ! ! ! 

About  to  delete  the  switch  CSR. 

ARE  YOU  SURE   (yes,  y,   no,   n) :    [no]  y 

To  import  a  certificate: 

switch :admin>  seccertutil  import 
Select  protocol   [ftp  or  scp] :  ftp 
Enter  IP  address:   ip  address 

Enter  remote  directory:   dir  name  where  certificate  is  stored 

Enter  certificate  name   (must  have  ".crt"  or  ".pern"  suffix) :  filename 

Enter  Login  Name:  login 

Enter  Password:  password 

Success:  imported  certificate  [certificate  file  name]. 

To  import  a  certificate  with  configure  and  enable  option: 

switch :admin>  seccertutil  import  -config  swcert  -enable  https 
Select  protocol   [ftp  or  scp] :  ftp 
Enter  IP  address:   ip  address 

Enter  remote  directory:   dir  name  where  certificate  is  stored 

Enter  certificate  name   (must  have  ".crt"  or  ".pern"  suffix) :  filename 

Enter  Login  Name:  login 

Enter  Password:  password 

Success:  imported  certificate  [certificate  file  name]. 
Certificate  file  in  configuration  has  been  updated. 
Secure  http  has  been  enabled. 

To  display  contents  of  a  CSR: 

switch :admin>  seccertutil  showcsr 


Fabric  OS  5.x  command  reference  guide  561 


To  display  contents  of  a  certificate: 

switch: admin>  seccertutil  show  certificate  file  name 

See  also 

none 
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secDefineSize 


Displays  the  size  of  the  defined  security  database. 


Synopsis 

secdef inesize 

Availability 

admin 

Description 

Use  this  command  to  display  the  size  of  the  defined  security  database. 
The  maximum  size  is  256  KB. 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff.  The  information 
displayed  might  not  be  supported  between  releases  and  is  subject  to  change  arbitrarily. 

[—)f  NOTE:   This  command  must  be  issued  in  secure  mode. 


Operands 


none 


Examples 


To  display  the  size  of  the  defined  security  database: 


switch : admin>  secdef inesize 


Size  of  security  defined  data:   35  bytes    (Max  262144  bytes) 


See  also 


secActiveSize 


secGlobalShow 
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secFabricShow 


Displays  security-related  fabric  information. 

Synopsis 

secf abricshow 

Availability 

all  users 

Description 

This  command  displays  the  security-related  information  about  the  fabric. 

The  information  displayed  is  as  follows: 

Role  Displays  whether  the  switch  is  the  primary  FCS,  backup  FCS,  or  not 

FCS. 

WWN  Displays  the  world  wide  name  of  the  switch. 

Did  Displays  the  domain  of  the  switch. 

Status  Displays  the  security  state  of  the  switch: 

Ready  -  This  switch  is  in  a  stable  state. 

Busy  -  This  switch  is  updating  its  security  database. 

Error  -  This  switch's  security  database  is  inconsistent  with  the  primary 

FCS. 

Enet  IP  Addr  Displays  the  Ethernet  IP  address. 

Name  Displays  the  switch  name. 

NoResp  Displays  if  the  switch  did  not  respond  to  the  status  query. 

Unknown  Displays  if  the  switch  is  in  an  unknown  state. 


[—)?  NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 

When  this  command  is  issued  on  multiple  switches  in  the  fabric,  one  or  more  of  these  switches  can 
display  a  status  of  busy. 


Operands 

none 

Examples 

To  display  security-related  fabric  information  on  the  primary  FCS  switch: 

switch : admin>  secf abricshow 

Role        WWN  Did  Status     Enet  IP  Addr  Name 

non-FCS  10:00:00:60:69:10:03:23  1  Ready  192.168.100.148  "nonfcs" 
Backup  10:00:00:60:69:00:12:53  2  Ready  192.168.100.147  "backup" 
Primary  10:00:00:60:69:22:32:83       3  Ready       192.168.100.135  "switch" 


Secured  switches  in  the  fabric:  3 
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See  also 

secPolicyDump 
secPolicyShow 
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secFCSFailover 

Enables  a  backup  FCS  switch  to  take  over  as  primary  FCS  switch. 

Synopsis 

secfcs fail over 


Availability 

admin 

Description 

Use  this  command  to  enable  a  backup  FCS  switch  to  take  over  as  the  primary  FCS  switch. 

This  command  can  be  issued  only  on  a  backup  FCS  switch.  After  this  command  is  issued,  the  primary 
FCS  switch  aborts  its  current  transaction  and  moves  the  backup  FCS  switch  to  the  top  of  the  FCS  list.  The 
former  primary  FCS  switch  then  activates  the  new  policy  set  and  the  former  backup  FCS  switch  becomes 
the  new  primary  FCS  switch  in  the  fabric. 

The  purpose  of  this  command  is  to  recover  from  a  scenario  in  which  all  available  access  to  the  primary 
FCS  switch  is  lost,  such  as  the  Ethernet  and  serial  connections. 

Operands 

none 


Examples 

To  enable  a  backup  FCS  switch  to  take  over  as  the  primary  FCS  switch: 

switch : admin>  secf csf ailover 

This  switch  is  about  to  become  the  Primary  FCS  switch. 

All  transactions  of  the  current  Primary  FCS  switch  will  be  aborted. 

ARE  YOU  SURE     (yes,   y,   no,   n) :    [no]  y 

WARNING ! ! ! 

The  FCS  policy  of  Active  and  Defined  Policy  sets  have  been  changed. 
Review  them  before  you  issue  secPolicyActivate  again. 


See  also 

secFabricShow 
secModeDi sable 
secModeShow 
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secGlobalShow 


Displays  the  current  internal  security  state  information. 


Synopsis 


secglobalshow 


Availability 


admin 


Description 


Use  this  command  to  display  security  server  (seed)  specific  information  as  a  snapshot  of  its  current  state. 
The  information  can  include  some  of  the  following: 

•  The  version  and  general  information 

•  The  current  status  of  the  RCS  transaction 

•  The  active  and  defined  sizes  of  the  security  database 

This  command  is  intended  strictly  for  debugging  purposes  by  technical  support  staff  only.  The  information 
displayed  might  not  be  supported  between  releases  and  is  subject  to  change  arbitrarily. 

[^3f  NOTE:    This  command  must  be  issued  when  secure  mode  is  enabled. 


Operands 


none 


Examples 


To  view  the  current  security  state: 


switch :admin>  secglobalshow 


See  also 


secActiveSize 


secDef ineSize 
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secHelp 

Displays  information  about  security  commands. 

Synopsis 

sechelp 

Availability 

all  users 

Description 

Use  this  command  to  display  a  list  of  security  commands. 

Operands 

none 
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Examples 

To  display  a  list  of  security  telnet  commands: 


switch : admin>  sechelp 

pkiCreate 

Creates  new  pki  objects 

pkiRemove 

Removes  pki  objects 

pkiShow 

Displays  existence  of  pki  objects 

secActiveSize 

Displays  size  of  the  active  (security)  database 

secAuthSecret 

Creates /Manages /Displays  DHCHAP  secret  key  details 

secCertUtil 
certificates 

Creates /Manages /Displays  third  party  PKI 

secDef ineSize 

Displays  size  of  the  defined  (security)  database 

secFabricShow 

Displays  security  related  fabric  information 

secFCSFai lover 

Forces  primary  role  to  this  FCS  switch 

secGlobalShow 

Displays  current  internal  security  state  information 

secModeEnable 

Enables  secure  mode 

secModeDisable 

Disables  secure  mode 

secModeShow 

Displays  whether  secure  mode  is  enabled  or  disabled 

secNonFCSPasswd 

Sets  the  admin  passwd  for  non-FCS  switches 

secPolicyAbort 

Aborts  changes  to  defined  policy 

secPolicyActivate 

Activates  all  policy  sets 

secPolicyAdd 

Adds  members  to  an  existing  policy 

secPolicyCreate 

Creates  a  new  policy 

secPolicyDelete 

Deletes  an  existing  policy 

secPolicyFCSMove 

Moves  a  member  in  the  FCS  policy 

s e c Po 1 i cyRemo ve 

Removes  members  from  an  existing  policy 

secPolicySave 

Saves  defined  policy  set  and  sends  to  all  switches 

secPolicyShow 

Shows  members  of  one  or  more  policies 

s  e  c  Po 1 i  cyDump 

Displays  all  members  of  existing  policies 

secStatsReset 

Resets  security  statistics 

sec Stats Show 

Displays  security  statistics 

secTempPasswdSet 

Sets  temporary  password 

secTempPasswdReset 

Resets  temporary  password 

secTransAbort 

Aborts  current  transaction 

secVersionReset 

Resets  version  stamp 

See  also 

none 
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secModeDisable 

Disables  secure  mode. 

Synopsis 

secmodedi sable 

Availability 

admin 

Description 

Use  this  command  to  disable  secure  mode  on  all  switches  in  the  fabric.  This  command  deletes  both  the 
defined  and  active  security  database. 

This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
Operands 

none 

Examples 


To  disable  security  mode: 

primaryf cs : admin>  secmodedisable 
Please  enter  current  admin  account 

password: 

Warning ! ! ! 

About  to  disable  security. 

ARE  YOU  SURE   (yes,   y,   no,   n) :  [no] 

Y 

secFabricShow 

secModeShow 
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secModeEnable 

Enables  secure  mode. 

Synopsis 

secmode enable   [ --quickmode]    |    [ [ --currentpwd]    [--lockdown [=scc  |=dcc]] 
[--fcs  list_of_switches   \  list_of_switches]] 

Availability 

admin 

Description 

Use  this  command  to  enable  secure  mode  on  all  switches  in  the  fabric.  This  command  fails  if  any  switch 
in  the  fabric  is  not  capable  of  enforcing  the  security  policies  defined  in  the  security  database.  If  no 
operand  is  specified,  the  command  becomes  interactive. 


[—)f  NOTE:    This  command  must  be  issued  from  a  sectelnet  or  SSH  session. 


This  command  sets  up  security  in  the  fabric  by: 

*  Activating  security  mode  on  all  switches  in  the  fabric. 

*  Creating  the  security  database,  populated  with  a  list  of  FCS  switches  in  the  FCS_POLICY. 

•  Distributing  the  security  database  to  all  switches  in  the  fabric. 

•  Resetting  the  root,  factory,  admin,  and  user  account  passwords  on  all  FCS  switches. 

•  Resetting  the  admin  and  user  account  passwords  on  all  non-FCS  switches. 

*  Disabling  the  root  and  factory  accounts  on  all  non-FCS  switches  in  the  fabric. 
The  administrator  is  prompted  to  enter  new  passwords  for  the  following  accounts: 


•  root 

•  admin 

•  user 

•  non-FCS  admin 

The  prompts  do  not  appear  if  the  administrator  chooses  to  use  the  passwords  on  the  primary  FCS  with  the 
--currentpwd  option.  With  this  option,  the  admin  password  is  used  for  non-FCS  admin  as  well. 

If  the  fabric  is  not  in  secure  mode  and  one  or  more  specified  FCS  switches  is  present  in  the  fabric,  the 
command  must  be  issued  on  the  first  active  FCS  in  the  list. 

If  the  fabric  is  not  in  secure  mode  and  no  specified  FCS  switches  are  present  in  the  fabric,  the  command 
can  be  issued  on  any  switch.  Only  the  -  -fcs  option  can  be  used  in  this  case. 

If  the  fabric  is  not  in  secure  mode  and  this  command  is  issued,  the  switches  in  the  fabric  with  Fabric  OS 
versions  previous  to  v4.4.0  or  v3.2.0  reboots  automatically. 


factory 
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If  the  fabric  is  in  secure  mode  and  no  FCS  switches  are  present  in  the  fabric,  the  command  can  be  issued 
on  any  switch.  This  is  used  to  recover  a  secure  fabric  that  has  no  FCS  switch.  Only  the  --fcs  option  can 
be  used  in  this  case. 


r2^f  NOTE:    Using  Fabric  OS  CLI  or  Web  Tools,  ensure  that  all  users  are  logged  off  the  fabric  before 
b_ I    enabling  secure  mode;  otherwise,  users  on  non-FCS  switches  lose  their  telnet  sessions. 

HP  recommends  that  a  maximum  of  80  WWNs  be  specified  in  the  FCS  policy  using  the  command.  To 

add  more  WWNs  use  the  secPolicyAdd  command. 


Operands 

This  command  has  the  following  operands: 

list_of_switches      Specify  a  list  of  switches  for  the  FCS  policy.  The  list  of  switches  must 

be  enclosed  in  quotation  marks,  and  each  member  switch  must  be 
separated  from  the  others  by  semicolons.  The  members  can  be 
specified  using  domain,  WWN,  or  switch  name  format,  as  follows: 

"5;    10:00:00:60:69:00:00:20;  starl" 

If  a  member  is  specified  by  domain  or  switch  name,  the  switch  must 
be  in  the  fabric  or  the  command  fails. 

This  operand  is  optional.  If  no  operand  is  specified,  the  session 
becomes  interactive  and  you  are  prompted  to  enter  FCS  member 
values. 

Specify  a  list  of  switches  for  the  FCS  policy.  Specifying  "*"  defaults 
this  to  all  the  switches  currently  present  in  the  fabric.  If  a  member  is 
specified  by  domain  or  switch  name,  the  switch  must  be  in  the  fabric 
or  the  command  fails. 

If  the  list  of  FCS  switches  is  not  specified,  the  session  becomes 
interactive  and  the  user  is  prompted  to  enter  FCS  members. 

Use  the  current  passwords  of  the  switch  the  command  is  run  on  (the 
primary  FCS  switch)  for  root,  factory,  admin  and  user  accounts. 
Non-FCS  admin  account  password  is  set  the  same  as  FCS  admin 
account  password.  The  command  does  not  prompt  for  new 
passwords.  Only  sessions  whose  account  password  has  changed 
are  logged  out.  This  option  can  be  used  only  on  a  fabric  with  secure 
mode  disabled  and  only  when  the  command  is  run  on  the  switch 
specified  as  the  primary  FCS  switch. 

Create  SCC  and  DCC  policies  to  lockdown  the  fabric.  SCC  policy 
is  populated  with  all  the  switches  present  in  the  fabric  when  the 
command  is  executed.  DCC  policies  are  populated  with  the 
devices  present  in  the  fabric  when  the  command  is  executed, 
locking  down  devices  on  a  per  port  basis.  Ports  with  no  devices 
attached  to  them  also  are  locked  down  with  an  empty  DCC  policy 
so  no  device  can  be  connected  to  them,  preserving  the  fabric  as  is. 
The  lockdown  operand  creates  both  SCC  and  DCC  policies.  With 
the  optional  argument  of  --lockdown=scc  or 
--lockdown-dcc,  only  the  specified  policy  is  created.  This 
operand  can  be  used  only  on  a  fabric  with  secure  mode  disabled 
and  only  when  the  command  is  run  on  the  switch  specified  as  the 
primary  FCS  switch. 


-fcs 

list_of_swi tches 


-currentpwd 


-lockdown [ =scc 
=dcc  ] 
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--quickmode  This  option  is  a  shorthand  notation  for  a  combination  of  the 

--currentpwd,   --lockdown,   and  --fcs  "*"  options.  On 
successful  execution  of  the  command,  security  is  enabled  in  the 
fabric  with  all  switches  being  FCS,  all  switches  having  passwords 
identical  to  that  of  the  primary  FCS  and  SCC,  and  DCC  policies 
capturing  and  maintaining  the  current  configuration  of  the  fabric. 
This  option  can  be  used  only  on  a  fabric  with  secure  mode  disabled 
and  only  when  the  command  is  run  on  the  switch  specified  as  the 
primary  FCS  switch. 

If  no  operand  is  specified,  the  session  becomes  interactive  and  the  user  is  prompted  to  enter  FCS  switch 
members  and  passwords. 

If  the  -currentpwd  option  is  not  used,  the  session  becomes  interactive  and  the  user  is  prompted  to 
enter  new  passwords  for  root,  factory,  admin,  user,  and  non-FCS  admin  accounts. 

Examples 

To  enable  secure  mode  using  --quickmode: 

f csprimary : admin>  secModeEnable  --quickmode 

Your    use  of    the  certificate-based    security  features    of  the  software 

installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 

provided    with  the  equipment  and  the  Certification    Practices  Statement, 

which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By 
using 

these  security  features,  you  are  consenting  to  be  bound  by  the  terms  of 
these  documents.  If  you  do  not  agree  to  the  terms  of  these  documents, 
promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 
not  use  these  security  features. 

Do  you  agree  to  these  terms?     (yes,   y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:   On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

Non-FCS  admin  password  will  be  set  the  same  as  FCS  admin  password. 
ARE  YOU  SURE     (yes,  y,   no,   n) :    [no]  y 
Please  enter  current  admin  account  password: 
Secure  mode  is  enabled. 
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To  enable  a  security  policy  that  includes  three  FCS  switches  specified  by  domain,  WWN  address,  and 
switch  name: 


f csprimary : admin>  secmodeenable 

Your  use  of  the  certificate-based  security  features  of  the  software 
installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 
provided  with  the  equipment  and  the  Certification  Practices  Statement, 
which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By  using 
these  security  features,  you  are  consenting  to  be  bound  by  the  terms  of 
these  documents.  If  you  do  not  agree  to  the  terms  of  these  documents, 
promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 
not  use  these  security  features. 

Do  you  agree  to  these  terms?     (yes,   y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:  On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

This  is  an  interactive  session  to  create  a  FCS  list. 
The  new  FCS  list  is  empty. 

Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) :  102 
Switch  WWN  is  10 : 00 : 00 : 60 : 69 : 80 : 04 : Of . 

The  new  FCS  list: 
10:00:00:60:69:80:04:0f 

Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) : 
10:00:00:60:69:80:04:0e 

Switch  WWN  is  10:00:00:60:69:80:04:0e. 

The  new  FCS  list: 

10:00:00:60:69:80:04:0f 

10:00:00:60:69:80:04:0e 


(continued  on  next  page) 
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Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) :  swl 
Switch  WWN  is  10:00:00:60:69:80:04:0a. 

The  new  FCS  list: 
10:00:00:60:69:80:04:0f 
10:00:00:60:69:80:04:0e 
10:00:00:60:69:80:04:0a 

Enter  WWN,   Domain,   or  switch  name (Leave  blank  when  done) : 
Are  you  done?     (yes,  y,   no,   n) :    [no]  y 
Is  the  new  FCS  list  correct?      (yes,  y,   no,   n) :    [no]  y 
Please  enter  current  admin  account  password: 

Warning:  Access  to  the  Root  and  Factory  accounts  may  be  required  for 
proper  support  of  the  switch.  Please  ensure  the  Root  and  Factory 
passwords  are  documented  in  a  secure  location.  Recovery  of  a  lost  Root 
or  Factory  password  will  result  in  fabric  downtime. 

Changing  password  for  root 
New  FCS  switch  root  password: 
Re-type  new  password: 
(output  truncated) 
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To  enable  secure  mode  using  —  currentpwd  --fcs  "*": 

f csprimary : admin>  secModeEnable  --currentpwd  --fcs  "*" 

Your    use  of    the  certificate-based    security  features    of  the  software 

installed  on  this  equipment  is  subject  to  the  End  User  License  Agreement 
provided    with  the  equipment  and  the  Certification    Practices  Statement, 
which  you  may  review  at  http://www.switchkeyactivation.com/cps.  By 
using 

these  security  features,  you  are  consenting  to  be  bound  by  the  terms  of 
these    documents.     If  you    do  not  agree  to  the  terms  of  these  documents, 

promptly  contact  the  entity  from  which  you  obtained  this  software  and  do 

not  use  these  security  features. 

Do  you  agree  to  these  terms?     (yes,   y,   no,   n) :    [no]  y 

This  command  requires  Switch  Certificate,     Security  license  and  Zoning 
license  to  be  installed  on     every  switch  in  the  fabric. 

PLEASE  NOTE:   On  successful  completion  of  this  command,    login  sessions 
may  be  closed  and  some  switches  may  go  through  a  reboot  to  form  a  secure 
fabric . 

Non-FCS  admin  password  will  be  set  the  same  as  FCS  admin  password. 
ARE  YOU  SURE     (yes,   y,   no,   n) :    [no]  y 

Please  enter  current  admin  account  password: 

Secure  mode  is  enabled. 

See  also 

secFabricShow 
secModeDi sable 
secModeShow 
secPolicyShow 
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secModeShow 


Displays  whether  security  mode  is  enabled  or  disabled. 

Synopsis 

secmodeshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  security  mode  of  the  fabric.  The  fabric  can  be  in  secure  mode  or 
nonsecure  mode. 

The  command  displays  secure  mode  as  ENABLED  or  DISABLED.  If  the  fabric  is  in  secure  mode,  the 
following  information  appears: 

Version  stamp  Displays  the  current  version  and  build  date  and  time  of  the  security  database. 

FCS  switches  Displays  a  list  of  FCS  switches. 

Primary  Displays  whether  the  switch  is  a  primary  FCS  or  backup  FCS. 

WWN  Displays  the  WWN  of  the  FCS  switch. 

DID  Displays  the  domain  of  the  FCS  switch. 

swName  Displays  the  alias  name  of  the  FCS  switch. 

This  command  can  be  issued  on  any  switch  in  a  fabric. 

Operands 

none 

Examples 

To  display  the  current  security  mode  of  a  fabric: 

switch : admin>  secmodeshow 

Secure  Mode :   ENABLED . 

Version  Stamp:  9182,  Wed  Mar  17  16:37:01  2004. 
POS  Primary  WWN  Did  swName . 


1  Yes  10:00:00:60:69:00:00:5a  21  switch47 . 

2  No  12:00:00:60:60:03:23:5b  5     switchl2 . 


See  also 


secFabricShow 
secModeDi sable 
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secNonFcsPasswd 


Sets  the  admin  password  for  non-FCS  switches. 


Synopsis 


secnonf cspasswd 


Availability 


admin 


Description 


Use  this  command  to  change  the  admin  password  on  all  non-FCS  switches  in  the  fabric.  This  command 
can  be  issued  only  from  the  primary  FCS  switch  in  secure  mode.  The  changed  passwords  are  persistent 
across  reboots.  All  non-FCS  switches  that  join  the  fabric  in  the  future  inherit  this  new  password. 

The  password  must  be  between  8  and  40  characters  long  and  can  consist  of  any  combination  of 
alphanumeric  characters. 

This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 


NOTE:  Ensure  no  non-FCS  admin  users  are  logged  in  when  this  command  is  executed;  otherwise,  users 
on  non-FCS-switch  sessions  terminate. 


switch : admin>  secnonf cspasswd 
Changing  password  for  admin 
Non  FCS  switch  admin  password: 
Re-type  new  password: 

Login  sessions  with  password  changed  will  be  terminated. 
Password  for  non-FCS  admin  account  has  been  changed  successfully. 


Operands 


none 


Examples 


To  set  the  admin  password  for  all  non-FCS  switches  in  the  fabric: 


See  also 


passwd 


secModeDi sable 


secModeShow 


secTempPasswdSet 
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secPolicyAbort 


Aborts  all  changes  to  the  defined  database  that  have  not  been  saved. 


Synopsis 

secpolicyabort 

Availability 

admin 

Description 

Use  this  command  to  abort  all  changes  to  the  defined  security  database  that  have  not  been  saved  to  flash 
memory. 


f2^f  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  abort  all  changes  that  have  not  been  saved  to  flash  memory: 


secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 


primaryf cs : admin>  secpolicyabort 


Unsaved  data  has  been  aborted. 


primaryf cs : admin>  secpolicyabort 


No  new  data  to  abort . 


See  also 
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sec  Pol  icyActi  vote 


Applies  defined  policy  set  to  all  switches  in  the  fabric. 


Synopsis 

secpolicyactivate 
Availability 


Description 

Use  this  command  to  activate  the  current  defined  security  policy  to  all  switches  in  the  fabric.  After 
activation,  the  defined  policy  set  becomes  the  active  policy  set. 


[2^?  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  activate  the  defined  security  policy  set  to  all  switches  in  the  fabric: 


primaryf cs : admin>  secpolicyactivate 

About  to  overwrite  the  current  Active  data. 

ARE  YOU  SURE   (yes,   y,   no,   n) :    [no]  y 

secpolicyactivate  command  was  completed  successfully. 


secPolicyAbort 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 


admin 


See  also 


580   Fabric  OS  commands 


secPolicyAdd 


Adds  members  to  an  existing  security  policy. 


Synopsis 

secpolicyadd  name,  "member  [;  member...]" 

Availability 

admin 

Description 

Use  this  command  to  add  members  to  an  existing  access  policy.  The  new  members  must  not  already  be 
members  within  the  policy  or  the  command  fails. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  is  first  enabled  using  the  command,  only  the 
FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method;  all 
access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  all  members  are  then  deleted  from 
the  policy,  all  access  is  denied  for  that  management  access  method  (the  DCC_POLICY  is  an  exception). 


[2^>  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
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Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  an  existing  policy  to  which  you  want  to  add  members.  Valid  values 

for  this  operand  are: 

DCC_POLICY_rmn 

FCS_POLICY 


TELNETPOLICY 

HTTP_POLICY 

API_POLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOLICY 

FRONTPANEL_POLICY 

SCC_POLICY 

OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY _nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user-defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names,  but  they  are  case  sensitive. 

member  Specify  a  list  of  member  switches  for  the  security  policy.  The  members  must  be  enclosed 

in  quotation  marks  and  separated  by  semicolons.  Depending  on  the  policy  type, 
members  can  be  specified  using  IP  address,  WWN,  domain,  switch  name,  or  other. 

IP  Address  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  IP  address: 

•  TELNET_POLICY 
HTTP_POLICY 

•  API_POLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

These  policy  types  require  member  IPs  to  be  specified  in  dot  notation  (for  example, 
1  24.23.56.1  22).  If  0  is  specified  in  one  of  the  octets,  any  number  can  be  matched. 

WWN  Member  Policy  Types 
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The  following  policy  types  require  members  be  specified  by  WWN  address: 

•  FCS_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIAL_POLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

These  policy  types  require  members  be  specified  as  WWN  strings,  domain  IDs,  or 
switch  names.  If  domain  ID,  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  Members 

The  DCC_POLICY_.n.n.n  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  An  empty  DCC_POLICY  does  not  stop  access  to  the  switch.  The  device  is 
specified  with  a  WWN  string.  The  switch  and  port  combination  must  be  in  the 
following  format: 

switch  port 

switch  can  be  specified  using  WWN,  domain,  or  switch  name. 

port  can  be  specified  by  port  numbers  separated  by  commas  and  enclosed  in  either 
brackets  or  parenthesis:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will  include 
the  devices  currently  attached  to  those  ports. 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 
(1-6)        Selects  ports  1  through  6. 
(*)  Selects  all  ports  on  the  switch. 

[3,  9]       Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 

[1-3,  5]    Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 

[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 

OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option. 

Examples 

To  add  a  member  to  the  MS_POLICY  using  the  device  WWN: 

switch :admin>  secpolicyadd  "MS_POLICY" ,    " 12 : 24 : 45 : 10 : 0a : 67 : 00 : 40 " 
Member (s)  have  been  added  to  MS_P0LICY. 

To  add  an  SNMP  manager  to  WSNMP_POLICY: 

switch :admin>  secpolicyadd  "WSNMP_POLICY" ,  "192.168.5.21" 
Member (s)  have  been  added  to  WSNMP_P0LICY . 
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To  add  two  devices  to  attach  to  domain  3,  ports  1  and  3,  in  an  existing  empty  DCC  policy;  port  WWN 
of  the  first  device  is  1 1 :22:33:44:55:66:77:aa  and  port  WWN  of  the  second  device  is 
ll:22:33:44:55:66:77:bb: 

switch : admin>  secpolicyadd  " DCC_POLICY_abc " , 

"11:22:33 :44: 55: 66:77 :aa; 11:22 : 33 :44:55: 66:77 :bb; 3 (1,3) " 

Member ( s )  have  been  added  to  DCC_POLlCY_abc . 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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sec  Pol  icy  Create 

Creates  a  new  security  policy. 

Synopsis 

secpolicycreate  "name"   [,  "member  [ ; member. . .]" 


Availability 

admin 

Description 

Use  this  command  to  create  a  new  security  policy.  All  policies  can  be  created  only  once,  except  for  the 
DCC_POLICY _nnn.  Each  DCC_POLICY_nnn  must  have  a  unique  name. 

Adding  members  while  creating  a  policy  is  optional.  You  can  add  members  to  a  policy  later,  using  the 

secPolicyAdd  command. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  mode  is  first  enabled  using  the  command,  only 
the  FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method; 
all  access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  all  members  are  then  deleted  from 
the  policy,  all  access  is  denied  for  that  management  access  method. 


r2^f  NOTE:   The  FCS_POLICY  can  only  be  created  when  enabling  security  mode  using  the  command. 
L_J    If  a  TELNET  POLICY  or  SERIAL  POLICY  is  created,  that  ends  the  current  sectelnet  or  serial  session  and  a 
warning  is  issued. 

This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
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Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  a  policy  you  want  to  create.  Valid  values  for  this  operand  are: 

•  DCC_POLICY_rmn 

•  TELNET_POLICY 
HTTP_POLICY 

•  API_POLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 

•  MS_POLICY 

•  SERIALPOLICY 

•  FRONTPANEL_POLICY 

•  SCC_POLICY 

•  OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POUCY_m2n  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user-defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names.  Valid  values  for  DCC_POLICY_njin  are  user  defined 
alphanumeric  or  underscore  characters.  The  maximum  length  is  30  characters, 
including  the  prefix  DCC_POLICY_. 

member  Specify  a  list  of  members  for  the  security  policy.  The  members  must  be  enclosed  in 

quotation  marks  and  separated  by  semicolons.  Depending  on  the  policy  type,  members 
can  be  specified  using  IP  address,  WWN,  domain,  or  switch  name. 

IP  Address  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  IP  address: 

•  TELNET_POLICY 
HTTP_POLICY 

•  API_POLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

These  policy  types  require  member  IDs  in  dot  notation  (for  example,  124.23.56.122).  If 
0  is  specified  in  one  of  the  octets,  any  number  can  be  matched. 
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WWN  Member  Policy  Types 

The  following  policy  types  require  members  be  specified  by  WWN  address: 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIAL_POLICY 

FRONTPANEL_POLICY 

These  policy  types  require  member  IDs  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain,  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  Members 

The  DCC_Policy_nnn  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  The  device  is  specified  with  a  WWN  string.  The  switch  and  port 
combination  must  be  in  the  following  format: 

switch  port 

switch  can  be  specified  using  WWN,  domain,  or  switch  name. 

port  can  be  specified  by  port  numbers  separated  by  commas  and  enclosed  in  either 
brackets  or  parenthesis:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will  include  the 
devices  currently  attached  to  those  ports. 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 
(1-6)         Selects  ports  1  through  6. 
(*)  Selects  all  ports  on  the  switch. 

[3,  9]        Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 

[1-3,  5]     Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 

[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 

OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option. 
SCC_POLICY  Members 

This  policy  type  requires  member  IDs  to  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

To  add  all  switches  in  the  current  fabric  as  members  of  the  SCC_POLICY,  enter  an 
asterisk  (*)  as  the  member  value.  This  feature  cannot  be  used  by  the  other  security  telnet 
commands. 


Examples 


To  create  a  new,  single  MS_POLICY  that  enables  access  through  a  device  that  has  WWN  of 
1 2:24:45: 1 0:0a:67:00:40: 

switch :adirLin>  secpolicycreate  "MS_POLICY"  ,    "  12  :  24  :  45  : 10  :  0a :  67  :  0 0  :  40  " 
MS_P0LICY  has  been  created. 
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To  create  a  new  front  panel  policy  that  only  enables  domains  3  and  4  to  use  the  front  panel: 


switch: admin>  secpolicycreate  "FRONTPANEL_POLICY" ,    "3;  4" 
FRONT PANEL_POL ICY  has  been  created. 

To  create  a  device  policy  to  allow  two  devices  to  attach  to  domain  3  ports  1  and  3  (the  WWN  of  first 
device  is  1 1 :22:33:44:55:66:77:aa  and  the  WWN  of  second  device  is  1 1 :22:33:44:55:66:77:bb): 

switch: admin>  secpolicycreate  "DCC_P0LICY_aB_7 " , 

" 11:22 : 33 :44: 55 : 66:77 :aa; 11: 22: 33:44:55: 66: 77 :bb; 3 [1,3] " 

DCC_POLlCY_abc  has  been  created. 

To  create  a  telnet  policy  to  allow  anyone  on  the  1 92.1 68.5.0/24  network  to  access  the  fabric  through 
sectelnet: 


switch: 

admin> 

secpolicycreate  " TELNET_P0LICY " , 

"192.168.5.0" 

TELNET, 

.POLICY 

has  been  created. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Delete 


Deletes  an  existing  security  policy. 


Synopsis 

secpolicydelete "name1 

Availability 

admin 

Description 

Use  this  command  to  delete  an  existing  defined  policy.  The  FCS_POLICY  cannot  be  deleted  through  this 
command,  since  this  policy  must  exist  to  maintain  security  mode. 

Each  policy  corresponds  to  a  management  method.  The  list  of  members  of  a  policy  acts  as  an  access 
control  list  for  that  management  method.  When  security  mode  is  first  enabled  using  the  command,  only 
the  FCS_POLICY  exists.  Before  a  policy  is  created,  there  is  no  enforcement  for  that  management  method; 
all  access  is  granted.  After  a  policy  has  been  created  and  a  member  has  been  added  to  the  policy,  that 
policy  becomes  closed  to  all  access  except  from  included  members.  If  the  policy  is  deleted  all  access  is 
granted. 


[2^>  NOTE:    This  command  can  be  issued  only  in  secure  mode  and  only  from  the  primary  FCS  switch. 
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Operands 

This  command  has  the  following  operand: 

name  Specify  the  name  of  a  security  policy  to  delete.  The  policy  name  must  be  enclosed  in 

quotation  marks.  Valid  security  policy  names  are: 

DCC_POLICY_.nnn 

TELNET_POLICY 

HTTP_POLICY 

API_POLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIAL_POLICY 

FRONTPANE  IMPOLICY 

SCC_POLICY 

OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY _nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names. 

This  operand  is  required. 


NOTE:   After  security  policy  is  deleted,  fabric-wide  switch  access  through  that  method  is  unrestricted. 


Examples 

To  delete  an  existing  security  policy: 


switch: admin>  secpolicydelete  "MS, 

_POLICY" 

About  to  delete  policy  MS_P0LICY. 

Are  you  sure   (yes,   y,   no,   n) : [no] 

y 

MS_P0LICY  has  been  deleted. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDump 
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secPolicyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Dump 


Displays  all  members  of  existing  security  policies. 


Synopsis 

secpolicydump   [ "listtype" [ ,  "name"]] 

Availability 

all  users 

Description 

Use  this  command  to  display,  without  page  breaks,  the  members  of  an  existing  policy  in  the  active  and 
defined  (saved)  databases. 


■™J?  NOTE:    This  command  can  be  issued  only  in  secure  mode  but  from  any  primary  FCS  switch. 


Operands 


This  command  has  the  following  operands: 

listtype  Specify  which  database  to  display.  The  name  for  active  database  is  Active;  the 
name  for  saved,  defined  database  is  Defined.  If  not  specified,  all  databases  are 
displayed. 

name  Specify  the  name  of  a  security  policy  you  would  like  to  display.  Valid  values  for  this 

operand  are: 

DCC_POLICY_nmi 

FCS_POLICY 

TELNET_POLICY 

HTTP_POLICY 

API_POLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 
MS_POLICY 
SERIAL_POLICY 
FRONTPANEL_POLICY 
SCC_POLICY 
OPTIONS_POLICY 
The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY _nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names.  This  operand  is  optional. 
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Examples 

To  display  all  security  policy  information  from  all  databases  (active,  updating,  and  defined),  without 
page  breaks: 

primaryf cs : admin>  secpolicydump 


DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN  Did  swName 


1       Yes  10:00:00:60:69:30:15:5c       1  primaryf cs 

HTTP_POLICY 
IpAddr 


192 . 155 . 52  .  0 


ACTIVE   POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN  Did  swName 


1       Yes  10:00:00:60:69:30:15:5c       1  primaryf cs 

HTTP_POLICY 
IpAddr 


192  . 155 . 52 . 0 
192.155.53.1 
192.155.54.2 
192.155.55.3 


To  display  all  security  policy  information  for  the  TELNET  POLICY,  without  page  breaks: 

primaryf cs : admin>  secpolicydump  " *" ,    " TELNET_POLICY " 


DEFINED  POLICY  SET 

TELNET_POLICY 

IpAddr 


192  . 155 . 52 . 13 
192  . 155 . 52 . 11 


ACTIVE   POLICY  SET 


TELNET_POLICY 
IpAddr 


192  . 155 . 52 . 0 
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See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPolicyFCSMove 

Moves  a  member  in  the  FCS  policy. 

Synopsis 

secpolicyf csmove   [from,  to] 

Availability 

admin 

Description 

Use  this  command  to  move  an  FCS  member  from  one  position  to  another  in  the  FCS  list.  Only  one  FCS 
can  be  moved  at  a  time.  The  first  FCS  switch  in  the  list  that  is  also  present  in  the  fabric  is  the  primary  FCS. 

If  no  parameters  are  specified,  the  command  becomes  interactive,  prompting  you  to  supply  valid  values 
for  the  operands. 


r2^>  NOTE:  This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 
Efj    If  a  backup  FCS  is  moved  to  the  first  position,  it  becomes  the  primary  FCS  after  activation. 


Operands 

This  command  has  the  following  operands: 

from  Specify  the  position  of  the  FCS  switch  you  want  to  move. 

to  Specify  the  position  to  which  you  want  to  move  the  FCS  switch. 

If  no  operand  is  specified,  the  command  becomes  interactive  and  you  are  prompted  for  values. 
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Examples 

To  move  the  backup  FCS  switch  at  position  2  to  position  3  in  the  FCS  list: 


switch: admin>  secpolicyf csmove 

Pos       Primary  WWN 

Did  swName. 

1       Yes  10:00:00:60:69:10:02:18 

1  switch5 . 

2       No  10:00:00:60:69:00:00:5a 

2  switch60. 

3       No  10:00:00:60:69:00:00:13 

3  switch73. 

Please  enter  position  you'd  like  to  move  from     :  (1..3) 

[1]  2 

Please  enter  position  you'd  like  to  move  to     :    (1..3)  [ 

1]  3 

DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN 

Did  swName 

1       Yes  10:00:00:60:69:10:02:18 

1  switch5 . 

2       No  10:00:00:60:69:00:00:13 

3  switch73. 

3       No  10:00:00:60:69:00:00:5a 

2  switch60. 

See  also 

secFabricShow 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secPol  icy  Remove 


Removes  members  from  an  existing  policy. 

Synopsis 

secpolicyremove  "name"   [,   "member  [/member]"] 

Availability 

admin 

Description 

Use  this  command  to  remove  members  from  an  existing  security  policy.  If  a  policy  is  empty  after  removing 
all  members,  all  accesses  to  the  policy  are  disallowed  (the  DCC_POLICY  and  OPTIONS_POLICY  are 
exceptions).  You  cannot  remove  all  members  from  FCS_POLICY,  and  you  cannot  remove  the  FCS 
members  from  SCC_POLICY. 

"™J?  NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch.. 


Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  an  existing  policy  you  want  to  remove  members  from.  Valid  values 

for  this  operand  are:  DCC_POLICY_nnn 

FCS_POLICY 

TELNET_POLICY 

HTTP_POLICY 

API_POLICY 

RSNMP_POLICY 

WSNMP_POLICY 

SES.POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIALPOUCY 

FRONTPANE  IMPOLICY 

SCC_POLICY 

OPTIONS_POLICY 

The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY  policy  name  has  the  common  prefix  DCC_POLICY_  followed  by  a 
string  of  user  defined  characters.  These  characters  do  not  have  to  be  capitalized  like 
regular  policy  names,  but  are  case  sensitive.  This  operand  is  required. 
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member  Specify  a  member  or  list  of  members  to  delete  from  the  policy.  The  members  must  be 

enclosed  in  quotation  marks  and  separated  by  semicolons.  This  operand  is  required. 
Depending  on  the  policy  type,  members  can  be  specified  using  IP  address,  WWN, 
domain,  or  switch  name. 

IP  address  member  policy  types 

The  following  policy  types  require  members  be  specified  by  IP  address: 
TELNET_POLICY 
HTTP_POLICY 
API_POLICY 
RSNMP_POLICY 
WSNMP_POLICY 

These  policy  types  require  member  IDs  in  dot  notation  (for  example,  1  24.23.56.1  22). 
If  0  is  specified  in  one  of  the  octets,  it  means  any  number  can  be  matched. 

WWN  member  policy  types 

The  following  policy  types  require  members  be  specified  by  WWN  address: 
FCS_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 
MS_POLICY 
SERIAL_POLICY 
FRONTPANEL_POLICY 
SCC_POLICY 

These  policy  types  require  member  IDs  be  specified  as  WWN  strings,  domains,  or 
switch  names.  If  domain  or  switch  names  are  used,  the  switches  associated  must  be 
present  in  the  fabric  or  the  command  fails. 

DCC_POLICY  members 

The  DCC_Policy_nM  is  a  list  of  devices  associated  with  a  specific  switch  and  port 
combination.  The  device  is  specified  with  a  WWN  string.  The  switch  and  port 
combination  must  be  specified  in  the  following  format: 

switch  port 

switch  can  be  specified  using  WWN,  domain,  or  switch  name. 

port  can  be  specified  by  port  number  separated  by  commas,  and  enclosed  in  either 
brackets  or  parentheses:  for  example,  (2,  4,  6).  Ports  enclosed  in  brackets  will  include 
the  devices  currently  attached  to  those  ports.  The  following  examples  illustrate  several 
ways  to  specify  the  port  values: 

The  following  examples  illustrate  several  ways  to  specify  the  port  values: 
(1-6)         Selects  ports  1  through  6. 
(*)  Selects  all  ports  on  the  switch. 

[3,  9]       Selects  ports  3  and  9  and  all  devices  attached  to  those  ports. 
[1-3,  5]     Selects  ports  1  through  3  and  5  and  all  devices  attached  to  those  ports. 
[*]  Selects  all  ports  on  the  switch  and  devices  currently  attached  to  those  ports. 
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OPTIONS_POLICY  members 

NoNodeWWNZoning  is  the  only  option. 

Examples 

To  remove  a  member  that  has  a  WWN  of  1  2:24:45:1 0:0a:67:00:40  from  MS  policy: 

switch:admin>  secpolicyremove  "MS_POLICY" ,  " 12 : 24 : 45 : 10 : 0a : 67 : 0 0 : 40 " 
Member (s)   have  been  removed  from  MS_POLICY. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicySave 

secStatsShow 
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secPol  icy  Save 

Saves  a  defined  security  policy  to  flash  memory  on  all  switches  in  the  fabric. 

Synopsis 

secpolicysave 

Availability 

admin 

Description 

Use  this  command  to  save  a  defined  security  policy  to  flash  memory  of  all  switches  in  the  fabric. 
1^)f  NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  save  new  policy  set  in  all  switches  in  the  fabric: 

switch: admin>  secpolicysave 

secpolicysave  command  was  completed  successfully. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secStatsShow 
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secPolicyShow 

Displays  an  existing  security  policy. 

Synopsis 

secpolicyshow   [  "listtype "  [ ,  "name"]] 

Availability 

all  users 

Description 

Use  this  command  to  display  the  members  of  an  existing  policy  in  the  active  or  defined  security  policy 
database.  You  can  specify  which  database  to  display.  If  a  database  is  not  specified,  all  databases  are 
displayed. 

You  can  specify  to  display  a  security  policy  by  name.  If  no  name  is  specified,  all  policies  are  displayed 

This  command  displays  the  policy  database  one  page  at  a  time.  Use  secPolicyDump  to  display  the 
policy  database  without  page  breaks. 

NOTE:   This  command  can  be  executed  on  any  FCS  switch  in  fabric. 

Operands 

This  command  has  the  following  operands: 

listtype       Specify  which  database  to  display.  The  name  for  active  database  is  Active;  the 
name  for  saved,  defined  database  is  Defined.  This  operand  must  be  enclosed 
in  quotation  marks.  If  not  specified,  all  databases  are  displayed.  This  operand  is 
optional.  Use  an  asterisk  (*)  to  specify  both  active  and  defined. 

name  Specify  the  name  of  an  existing  policy  you  want  to  remove  members  from.  Valid 

values  for  this  operand  are:  DCC_POLICY _nnn 

•  FCS_POLICY 

•  TELNETPOLICY 
HTTP_POLICY 

•  API_POLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 
■  MS_POLICY 

•  SERIAL_POLICY 

•  FRONTPANEL_POLICY 

•  SCC_POLICY 

•  OPTIONS_POLICY 
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The  specified  policy  name  must  be  capitalized. 

The  DCC_POLICY _nnn  name  has  the  common  prefix  DCC_POLICY_  followed  by 
a  string  of  user  defined  characters.  These  characters  do  not  have  to  be 
capitalized  like  regular  policy  names,  but  is  case  sensitive.  This  operand  is 
optional. 

Examples 

To  display  all  security  policies  from  active  databases: 


switch : admin>  secpolicyshow  ' 

'active " 

ACTIVE  POLICY 

SET 

FCS_POLICY 

Pos       Primary  WWN 

Did 

swName 

1      Yes  10:00:00:60: 

;69:30:15: 

:  5C  1 

primaryf cs 

HTTP_POLICY 
IpAddr 

192 . 155  .  52  .  0 

To  display  all  security  policies  from  defined  databases: 


swi  tch : admin> 

secpolicyshow  "defined" 

DEFINED  POLICY  SET 

FCS_POLICY 

Pos       Primary  WWN 

Did 

swName 

1  Yes 

10:00:00:60:69:30:15: 

:  5c  1 

primaryf cs 

HTTP_POLICY 

IpAddr 

192 . 155 . 52 . 

.  0 

192 .155.53  . 

,  1 

192 . 155 . 54 . 

.2 

192.155.55, 

.3 

192.155.56. 

.4 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 
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secStats  Reset 

Resets  one  or  all  security  statistics  to  0. 

Synopsis 

secstatsreset   ["name"] [,"list"] 

Availability 

admin 

Description 

Use  this  command  to  reset  one  or  all  security  statistics  to  0.  This  command  can  be  issued  to  any  switch.  If 
issued  on  the  primary  FCS  switch,  this  command  can  reset  security  statistics  for  any  or  all  switches  in  the 
fabric. 
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Operands 


This  command  has  the  following  operands: 


list 


Specify  the  name  of  a  security  statistic  you  would  like  to  reset.  If  executed 
on  the  primary  FCS,  specify  an  asterisk  (*)  to  represent  all  security  policies. 
Valid  values  for  this  operand  are: 

TELNET_POLICY 

HTTP_POLICY 

API_POUCf 

RSNMP_POLICY 

WSNMP_POLICY 

SES_POLICY  (HP  does  not  support  SES_POLICY) 

MS_POLICY 

SERIAL_POLICY 

FRONTPANEL_POLICY 

SCC_POLICY 
DCC_POLICY 

LOGIN 

INVALIDJS 

INVALID_SIGN 

INVALIDCERT 

SLAP  FAIL 

SLAP_BAD_PKT 

TS_OUT_SYNC 

NO_FCS 

INCOMP_DB 

ILLEGALCMD 

The  specified  policy  name  must  be  all  capitalized. 

To  access  DCC  policies,  enter  DCC_POLICY.  Violations  are  not  tracked  for 
individual  DCC  policies.  The  statistics  for  all  DCC_POLICY  violations  are 
grouped  together. 

This  operand  is  optional  and  the  default  is  all  statistics.  If  the  list 
operand  is  specified,  this  operand  is  required. 

Specify  a  list  of  domain  IDs  on  which  to  reset  the  security  statistics.  Specify 
an  asterisk  (*)  to  represent  all  switches  in  the  fabric  or  specify  a  list  of 
domains,  separated  by  semicolons.  This  operand  is  optional  and  the 
default  value  is  the  local  switch. 
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Examples 

To  reset  all  statistics  on  the  local  switch: 

switch :admin>  secstatsreset 
About  to  reset  all  security  counters. 
Are  you  sure   (yes,   y,   no,   n) : [no]  y 
Security  statistics  reset  to  zero. 

To  reset  DCC_POLICY  statistics  on  domains  1  and  69: 

switch :admin>  secstatsreset  "DCC_POLICY" ,  "1;69" 
Reset  DCC_POLICY  statistic. 

See  also 

secFabricShow 
secStatsShow 
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secStatsShow 


Displays  one  or  all  security  statistics. 


Synopsis 

secstatsshow   ["name"] [,  "list"] 

Availability 

all  users 

Description 

Use  this  command  to  display  one  or  all  security  statistics.  This  command  can  be  issued  to  any  switch.  If 
issued  on  the  primary  FCS  switch,  this  command  can  retrieve  and  display  the  security  statistics  for  any  or 
all  switches  in  the  fabric. 


ptyf  NOTE:    This  command  displays  security  policy  statistics  in  secure  mode.  In  nonsecure  mode,  it  only 


reports  login  statistics. 


606   Fabric  OS  commands 


Operands 

This  command  has  the  following  operands: 

name  Specify  the  name  of  a  security  statistic  you  would  like  to  view.  If  executed  on  the 

primary  FCS,  specify  an  asterisk  (*)  to  represent  all  security  policies.  Valid  values  for 
this  operand  are: 

•  ELNET_POLICY 
HTTP_POLICY 

•  APLPOLICY 

•  RSNMP_POLICY 

•  WSNMP_POLICY 

•  SES_POLICY  (HP  does  not  support  SES_POLICY) 
-  MS_POLICY 

•  SERIAL_POLICY 

•  FRONTPANELPOLICY 

•  SCC_POLICY 

•  DCC_POLICY 

•  LOGIN 

•  INVALID_TS 

•  INVALID_SIGN 

•  INVALID_CERT 

•  SLAP  FAIL 

•  SLAP_BAD_PKT 

•  TS_OUT_SYNC 

•  NO_FCS 

•  INGOMP_DB 

•  ILLEGAL_CMD 

The  specified  policy  name  must  be  all  capitalized. 

To  access  DCC  policies,  enter  DCC_POLICY.  Violations  are  not  tracked  for  individual 
DCC  policies.  The  statistics  for  all  DCC_POLICY  violations  are  grouped  together. 

This  operand  is  optional  and  the  default  is  all  statistics.  If  the  list  operand  is 
specified,  then  this  operand  is  required. 

list  Specify  a  list  of  domains  to  display  the  security  statistics  on.  Specify  an  asterisk  (*)  to 

represent  all  switches  in  the  fabric  or  specify  a  list  of  domains  separated  by 
semicolons.  This  operand  is  optional  and  the  default  value  is  the  local  switch. 
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Examples 

To  display  the  MS_POLICY  statistics  on  the  local  switch: 

switch: admin>  secstatsshow  "MS_POLICY" 
Name  Value 


MS  2  0 

To  display  statistic  information  for  TELNET  POLICY  for  all  switches  in  the  fabric  (example  from  a 
nonsecure  switch): 


switch : admin>  secstatsshow  "TELNET_POLICY" , 

Fabric  Statistics: 

Domain  1 : 

Name  Value 

TELNET_POLICY  0 

Domain  69: 

Name  Value 

TELNET_POLICY  0 

Domain  70: 

Name  Value 

TELNET_POLICY  0 

See  also 

secFabricShow 
secStatsReset 
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secTem  pPasswd  Reset 


Resets  a  temporary  password  on  a  remote  switch. 


Synopsis 

secterappasswdreset   [ domain [ ,   " login_name" ]  ] 

Availability 

admin 

Description 


Use  this  command  to  remove  temporary  passwords  that  were  set  up  using  secTempPasswdSet 


If  a  login  name  is  not  supplied,  all  passwords  on  the  switch  identified  by  the  specified  domain  are 
refreshed.  If  the  domain  is  also  not  supplied,  all  temporary  passwords  for  all  login  levels  are  removed 
from  every  switch  in  the  fabric. 

Each  switch  has  four  accounts:  root,  factory,  admin,  and  user.  Root  and  factory  accounts  are  disabled  for 
non-FCS  switches.  If  they  are  temporarily  activated  by  secTempPasswdSet,  those  accounts  are 
disabled  by  secTempPasswdReset  or  rebooting  the  switch. 


f2^>  NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 


command. 


Operands 


This  command  has  the  following  operands: 


login_name 


domain 


Specify  the  domain  of  the  switch  from  which  the  temporary  passwords 
are  to  be  removed.  This  operand  is  optional. 

Specify  the  name  of  the  login  account  from  which  the  temporary 
password  are  removed.  This  operand  is  optional. 
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Examples 

To  remove  temporary  passwords: 


switch: admin>  sectemppasswdreset  2,  "root" 

Account  root  has  been  successfully  disabled  on  domain  2 


switch: admin>  sectemppasswdreset  2 

Restoring  password  of  every  account  on  domain  2 

Temporary  password  of  each  account  on  domain  2  has  been  successfully 
reset   (if  switch  is  non  fcs  switch  it  will  further  display) . 

Root  and  factory  accounts  on  domain  2  have  been  disabled. 


switch: admin>  sectemppasswdreset 

All  temporary  passwords  or  account  settings  have  been  restored  to 
fabric-wide  secure  settings. 

Passwords  of  permanent  accounts  have  been  reset  to  fabric-wide 
values.   Root  and  factory  accounts  on  each  Non  FCS  switch  have 
been  disabled. 

See  also 

secModeDi sable 
secModeShow 
secNonFcsPasswd 
secTempPasswdSet 
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secTempPasswdSet 


Sets  a  temporary  password  on  a  remote  switch. 

Synopsis 

sectemppasswdset  domain,    " login_name" 

Availability 

admin 

Description 

Use  this  command  to  set  a  unique  temporary  password  for  a  given  account  on  a  specific  switch  in  the 
fabric.  Use  the  secTempPasswdReset  command  to  remove  the  temporary  password  or  reboot  the 
switch. 

You  can  change  any  password  on  any  switch.  To  change  the  password  of  an  account  that  has  higher 
level  than  that  of  the  current  user  logged  in  to  the  primary  FCS  switch,  you  must  enter  the  password  of  the 
same  level  account  on  the  primary  FCS  switch. 

The  password  setup  on  the  target  is  not  persistent  and  will  be  reset  to  the  secure  fabric-wide  setting  when 
this  target  switch  is  rebooted  or  when  secTempPasswdReset  is  run  on  primary  FCS  switch. 

Each  switch  has  four  accounts:  root,  factory,  admin,  and  user.  Root  and  factory  accounts  are  disabled  for 
non-FCS  switches.  This  command  can  enable  the  root  or  factory  account  on  a  non-FCS  switch  when  you 
specify  a  password  for  those  accounts. 

The  password  should  between  8  and  40  characters. 


NOTE:    This  command  can  be  issued  only  from  secure  mode  and  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operands: 

domain  Specify  the  domain  of  the  switch  from  which  the  temporary  passwords 

are  to  be  removed.  This  operand  is  optional. 

login_name      Specify  the  name  of  the  login  account  from  which  the  temporary 
password  are  removed.  This  operand  is  optional. 

Example 

To  set  the  password  on  a  remote  switch  with  a  Domain  of  2: 

switch :admin>  sectemppasswdset  2,  "root" 

Please  provide  password  of  root  on  primary  FCS  switch 

in  order  to  change  this  password:  ******** 

Set  remote  switch  root  password:  ******** 

Re-enter  new  password:  ******** 

Account  root  has  been  successfully  enabled  on  domain  2 
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See  also 

passwd 

secModeDi sable 
secModeShow 
secNonFcs Passwd 
secTempPasswdReset 
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secTrans  Abort 


Aborts  current  security  transaction. 

Synopsis 

sectransabort 

Availability 

admin 

Description 

Use  this  command  to  abort  the  current  transaction.  This  command  is  used  to  recover  from  management 
application  problems.  This  command  aborts  all  current  changes  that  have  not  been  committed  or 
activated. 


"™J?  NOTE:    This  command  can  be  issued  from  any  switch  in  secure  mode. 


Operands 

none 

Examples 

To  abort  the  current  security  transaction: 

switch :admin>  sectransabort 
Transaction  has  been  aborted. 

See  also 

secPolicyAbort 

secPolicyActivate 

secPolicyAdd 

secPolicyCreate 

secPolicyDelete 

secPolicyDump 

secPolicyRemove 

secPolicySave 

secStatsShow 
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secVersionReset 


Resets  the  security  version  stamp  to  0. 

Synopsis 

secversionreset 

Availability 

admin 

Description 

Use  this  command  to  reset  the  security  version  stamp  of  all  switches  in  a  fabric  to  0,  so  that  it  can  be 
joined  to  another  secure  fabric. 

When  merging  two  or  more  secure  fabrics: 

1.  Determine  which  secure  fabric  will  become  the  FCS_POLICY  controller  fabric:  the  dominant  fabric  to 
which  all  other  secure  fabrics  will  be  merged. 

2.  Use  the  secPolicyAdd,  secPolicyRemove,  and  secPolicyActivate  commands  to  modify  the 
FCS_POLICY  of  the  merging  fabrics  to  match  the  FCS_POLICY  of  the  controller  fabric.  All  secure 
fabrics  to  be  merged  must  have  identical  FCS_POLICY  lists.  The  FCS  policies  of  merged  fabrics  must 
match  exactly;  they  must  contain  the  same  FCS  members  and  in  the  same  order,  or  the  merge  will  fail. 

3.  Reset  the  version  stamp  using  the  secVersionReset  command  on  each  secure  fabric  to  be  merged 
into  the  controller  fabric.  The  controller  fabric  does  not  require  a  version  reset. 

4.  Cascade  the  fabrics  together.  When  the  secure  fabrics  merge,  the  primary  FCS  switch  in  the  controller 
fabric  propagates  its  security  policies  across  the  newly  formed  fabric. 


NOTE:  This  command  must  be  issued  from  a  sectelnet  or  SSH  session  and  can  be  issued  only  from  the 
primary  FCS  switch,  a  non-FCS  when  there  is  no  FCS  switch  in  the  fabric,  or  from  a  disabled  switch. 


Operands 

none 

Example 

To  reset  the  version  stamp  to  0: 


See  also 


switch: admin>  secversionreset 

About  to  reset  version  stamp  to  0 

Are  you  sure   (yes,   y,   no,   n) : [no] 
done . 

y 

Security  Policy  Version  Stamp  has 

been  set  to  0 . 

secFabricShow 

secModeDi sable 

secModeShow 

secTrans Abort 
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sensorShow 

Displays  sensor  readings. 

Synopsis 

sensorshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  temperature,  fan,  and  power  supply  status  and  readings  from 
sensors  located  on  the  switch.  The  actual  location  of  the  sensors  varies,  depending  on  the  switch  type. 

Operands 

none 

Examples 

To  view  the  sensor  values: 


switch 

admin>  sensorshow 

sensor 

1 : 

(Temperature) 

is 

Ok, 

value 

is 

39  C 

sensor 

2  : 

(Temperature) 

is 

Absent 

sensor 

3  : 

(Temperature) 

is 

Absent 

sensor 

4: 

(Temperature) 

is 

Absent 

sensor 

5  : 

(Temperature) 

is 

Ok, 

value 

is 

26  C 

sensor 

6  : 

( Temperature ) 

is 

Ok, 

value 

is 

27  C 

sensor 

7  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2537 

RPM 

sensor 

8  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2537 

RPM 

sensor 

9  : 

(Fan  ) 

is 

Ok, 

speed 

is 

2556 

RPM 

sensor 

10  : 

(Power  Supply 

) 

is  Ok 

sensor 

11 : 

(Power  Supply 

) 

is  Absent 

sensor 

12  : 

(Power  Supply 

) 

is  Ok 

sensor 

13  : 

(Power  Supply 

) 

is  Absent 

See  also 

f anShow 
tempShow 
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setDbg 

Sets  debug  level  of  the  specified  module. 

Synopsis 

setdbg   [module_name]  [level] 

Availability 

admin 

Description 

Use  this  command  to  set  the  debug  level  of  a  specified  module. 


[2^f  NOTE:  High  debug  level  values  can  generate  a  large  volume  of  messages,  degrading  the  system 
b— I    response  time. 


Operands 

This  command  has  the  following  operands: 

module_name        Specify  the  name  of  the  module  for  which  you  want  to  view  the  debug  and 
verbosity  levels.  Module  names  are  case  sensitive.  This  operand  is  optional; 
if  omitted,  this  command  displays  the  debug  and  verbose  level  for  all 
modules. 

level  Specify  the  debug  level  for  the  specified  module  (0  to  9).  A  0  value 

(default)  specifies  that  no  messages  are  to  display.  Higher  values  cause 
more  messages  from  that  module  to  display.  This  operand  is  optional,  if 
omitted,  this  command  displays  the  current  debug  and  verbose  level  of  the 
specified  module. 

Examples 

To  set  debug  level  of  module  named  NS  to  value  3: 


switch 

admin> 

setdbg  NS  3 

switch 

admin> 

dbgshow  NS 

Module 

NS, 

debug  level  =  3 ,  verbose  level  =  0 

See  also 

dbgShow 
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setEsdMode 

Enables  or  disables  ESD  mode. 

Synopsis 

setesdmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  ESD  mode.  The  mode  is  saved  in  flash  memory  and  stays  in  that 
mode  until  the  next  execution  of  setEsdMode.  The  mode  becomes  active  as  soon  as  this  command  is 
executed.  It  does  not  require  a  reboot  to  take  effect. 

ESD  mode  modifies  the  behavior  of  the  diagnostic  test  methods  and  post  scripts.  The  exact  behavior 
varies  but  most  commonly  consists  of  disabling  the  ports  defined  when  spinSilk  or  other  functional 
tests  are  run  for  ESD  or  EMI  testing  purposes. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  ESD  mode.  This 

operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This 

operand  is  optional. 

If  no  operand  is  specified,  the  current  value  displays. 

Examples 

To  display  the  ESD  mode: 

switch : admin>  setesdmode  -show 
Esd  Mode  is  0   (Disabled) . 

See  also 

spinSilk 
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setGbicMode 


Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   |  -show] 
setgbicmode   [mode   |  -show] 
setsfpmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  without  media  installed 
are  not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  ESD  mode.  This  operand  is 

optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This  operand  is 

optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch : admin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch: admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : admin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 

See  also 

crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setMediaMode 

Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   \  -show] 
setgbicmode   [mode   \  -show] 
setsfpmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  without  media  installed 
are  not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  ESD  mode,  0  to  disable  ESD  mode.  This  operand  is  optional. 

-show  Specify  this  operand  to  display  the  current  mode  setting.  This  operand  is  optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch : admin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch :admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : admin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 

See  also 

crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setModem 


Enables  or  disables  modem  dial-in  to  a  control  processor  (CP). 

Synopsis 

setmodem   [-e]    |  [-d] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  modem  dial-in  to  a  CP  on  those  systems  that  support  modem 
dial-in.  When  modem  dial-in  is  enabled,  you  can  log  in  to  a  CP  through  a  modem,  and  a  modem 
attached  to  the  CP  accepts  the  call.  When  modem  dial-in  is  disabled,  the  modem  attached  to  the  CP  does 
not  accept  the  calls.  When  entered  with  no  operands,  the  command  displays  the  currently  state  of  modem 
dial-in. 

Modem  dial-in  must  be  through  a  Hayes-compatible  modem  attached  to  a  CP  modem  serial  port.  If  the 
CP  is  active,  the  modem  is  configured  to  answer  an  incoming  call  on  the  first  ring,  unless  modem  dial-in 
has  been  disabled  with  this  command.  If  the  CP  is  standby,  the  modem  is  configured  to  answer  an 
incoming  call  on  the  seventh  ring,  unless  modem  dial-in  has  been  disabled. 

In  the  recommended  configuration,  a  separate  modem  is  connected  to  each  modem  port  of  CPO  and 
CP1 .  These  modems  connect  to  the  telephone  outlet  through  a  RJ-1 1  Y-adapter  and  standard  telephone 
wire  (see  Figure  1 ). 

During  an  incoming  call,  both  modems  ring  and  the  one  connected  to  the  active  CP  answers  the  call  first. 
If  for  any  reason  the  active  modem  fails  to  answer,  the  caller  is  logged  in  to  the  standby  CP. 

When  both  CP  cards  are  connected  to  a  shared  telephone  line,  callers  are  automatically  dialed  in  to  the 
active  CP  card,  which  answers  on  the  first  ring  unless  modem  dial-in  has  been  disabled.  If  the  active  CP 
card  cannot  answer  for  any  reason,  the  standby  CP  card  answers  on  the  seventh  ring  and  allows  the 
login  to  proceed,  unless  modem  dial-in  has  been  disabled. 
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See  the  hardware  reference  manual  for  your  platform  for  complete  modem  installation  instructions. 


Figure  1  Two  modems  attached  for  high  availability 

Operands 

The  optional  operands  are  as  follows: 

-e  Specifies  that  modem  dial-in  be  enabled, 

-d  Specifies  that  modem  dial-in  be  disabled. 

Examples 

To  disable  modem  dial-in  to  a  CP: 

switch : admin>  setmodem  -d 

disabling  modem,  please  wait,  this  can  take  a  couple  of  minutes... 
modem  disabled 

See  also 

none 
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setSfpMode 

Enables  or  disables  media  mode. 

Synopsis 

setmediamode   [mode   \  -show] 
setgbicmode   [mode   \  -show] 
setsfpmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  these  commands  to  enable  media  mode  (GBIC  or  SFP)  if  the  mode  value  is  nonzero  and  disable  the 
media  mode  if  the  mode  value  is  0.  The  mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the 
next  execution  of  setMediaMode,  setSfpMode,  or  setGbicMode.  The  mode  becomes  active  as  soon 
as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

Media  mode  modifies  the  behavior  of  the  diagnostic  test  methods  so  that  ports  without  media  installed 
are  not  tested.  Normally,  tests  such  as  crossPortTest  or  spinSilk  fail  if  any  port  is  not  operating 
properly,  but  with  media  mode  enabled,  the  functional  tests  are  skipped  on  ports  that  do  not  contain 
media. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  media  mode  or  0  to  disable  media  mode.  If  no 

mode  is  specified,  the  current  value  is  displayed.  Any  other  value  will 
enable  media  mode. 

■show  Specify  the  -show  operand  to  display  the  current  setting.  This  operand  is 

optional. 

Examples 

To  enable,  disable,  and  then  display  the  media  mode: 

switch : admin>  setgbicmode  1 
GBIC  mode  is  now  1    (Enabled) . 
switch: admin>  setsfpmode  0 
SFP  mode  is  now  0   (disabled) . 
switch : admin>  setmediamode  -show 
Media  mode  is  now  0   (disabled) . 

See  also 

crossPortTest 

itemList 

miniCycle 

spinJitter 

spinSilk 
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setSplbMode 

Sets  or  displays  single  port  loopback  (SPLB)  mode. 

Synopsis 

setsplbmode   [mode   |  -show] 

Availability 

admin 

Description 

Use  this  command  to  enable  MFG  mode  if  mode  is  a  nonzero,  and  disable  SPLB  mode  if  mode  is  0.  The 
mode  is  saved  in  flash  memory  and  stays  in  that  mode  until  the  next  execution  of  setSplbMode.  The 
mode  becomes  active  as  soon  as  this  command  is  executed.  It  does  not  require  a  reboot  to  take  effect. 

The  SPLB  mode,  when  enabled,  forces  the  spinSilk  command  to  disable  two-port  loopback  for 
M->M  connected  ports.  This  might  be  useful  to  isolate  internal  switch  problems  from  SFP  problems  since 
the  internal  paths  are  used  much  less  with  SPLB  mode  enabled. 

Disabling  SPLB  mode,  forces  the  spinSilk  command  to  circulate  frames  between  pairs  of  M->M 
connected  ports  as  follows: 

PI   TX  >»   PI   RX   ->   P2   TX  »>   P2   RX   ->   PI  TX 

»>  is  a  cable  or  internal  loopback. 
■>  is  a  routing  table  entry. 

The  connections  between  pairs  of  M->M  ports  are  chosen  to  exercise  the  connections  between  as  many 
chips  (or  bloom  quadrants)  as  possible,  subject  to  the  setting  of  allow_intra_chip  and  the  availability  of 
pairs  of  M->M  ports. 

Any  ports  that  are  cross-cabled  are  routed  to  each  other  in  the  normal  manner,  regardless  of  the  setting  of 
SPLB  mode: 

PI  TX  >»  P2  RX  ->  PI  TX 
P2   TX  >»   PI   RX   ->   P2  TX 

Operands 

This  command  has  the  following  operands:  : 

mode  Specify  1  to  enable  SPLB  mode  or  0  to  disable  SPLB  mode.  If  no  mode  is 

specified,  the  current  value  is  displayed.  This  operand  is  optional;  if 
omitted,  the  command  displays  the  current  setting. 

-show  Specify  the  -show  operand  to  display  the  current  setting.  This  operand  is 

optional. 

Examples 

To  enable  or  disable  a  two-port  loopback: 

switch :admin>  setsplbmode  -show 
Splb  Mode  is  0  (Disabled) 

See  also 

spinSilk 
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setVerbose 

Specifies  module  verbose  level. 

Synopsis 

setverbose   [module_name]  [level] 

Availability 

admin 

Description 

Use  this  command  to  set  the  verbose  level  of  the  specified  module.  These  levels  filter  the  display  of  the 
debug  messages  to  the  serial  console.  By  default,  no  debug  messages  are  displayed. 

Operands 

This  command  has  the  following  operands: 

module_name  Specify  the  name  of  the  module  for  which  verbose  level  is  to  be 

set;  module  names  are  case  sensitive. 

-level  Specify  the  verbose  level  (0  to  9). 

Examples 

To  set  the  verbose  level  of  a  module  named  NS  to  value  3: 

switch: admin>  setverbose  NS  3 
switch: admin>  dbgshow  NS 

Module  NS,  debug  level  =  0,  verbose  level  =  3 

See  also 

dbgShow 


624   Fabric  OS  commands 


sfpShow 


Displays  serial  ID  SFP  information. 

Synopsis 

sfpshow   [ slotnumber/ ] [portnumber]    |  [-all] 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  serial  identification  SFPs  (also  known  as  module 
definition  4  SFPs).  These  SFPs  provide  extended  information  that  describes  the  SFPs  capabilities, 
interfaces,  manufacturer,  and  other  information. 


r2^f  NOTE:    SFPs  are  polled  by  a  background  process.  The  sfpShow  command  retrieves  the  latest 
b_ I    information  from  cache.  The  cache  values  for  each  SFP  are  updated  when  the  SFP  is  hot  plugged,  when 
it  is  removed,  or  when  the  Fabric  OS  polls  the  SFPs.  In  the  HP  StorageWorks  Core  Switch  2/64,  and  the 
SAN  Director  2/1 28  and  4/256,  if  there  is  a  lot  of  activity  on  the  switch,  poll  updates  might  take  several 
minutes. 


Use  this  command  with  no  operand  to  display  a  summary  of  all  SFPs  in  the  switch.  The  summary  displays 
the  SFP  type  (see  switchShow  for  an  explanation  of  the  two-letter  codes)  and,  for  serial  ID  SFPs,  the 
vendor  name  and  SFP  serial  number. 

Use  this  command  with  the  slotnumber  and  portnumber  operands  to  display  detailed  information 
about  the  serial  ID  SFP  in  that  port.  Use  the  -all  operand  to  display  detailed  information  for  all 
available  SFPs. 

For  Finisar  smart  SFPs,  five  additional  fields  appear:  module  temperature,  voltage,  received  optical 
power,  transmitted  optical  power  (longwave  only),  and  laser  diode  drive  current. 

Operands 

This  command  has  the  following  operands: 

slotnumber  For  bladed  systems  only,  specify  the  slot  number  of  the  port  to  display, 

followed  by  a  slash  (/). 

portnumber  Specify  the  port  number  to  display,  relative  to  its  slot  for  bladed 

systems.  Use  switchShow  to  list  valid  ports.  This  operand  is  optional; 
if  omitted,  this  command  displays  a  summary  of  all  SFPs  in  the  switch. 

-all  Displays  detailed  data  for  all  available  SFPs  on  the  switch.  This  operand 

is  not  compatible  with  slotnumber  /portnumber. 
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Examples 


To  display  SFP  summary  information: 

switch :user>  sfpshow 


Area 

0: 

id 

(id) 

Vendor : 

Serial 

NO: 

Area 

1: 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

NO: 

H1149T2 

Area 

2  : 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

NO: 

H112TUD 

Area 

3  : 

id 

(sw) 

Vendor : 

FINISAR 

CORP. 

Serial 

NO: 

H11QET9 

Area 

4  : 

id 

(sw) 

Vendor : 

IBM 

Serial 

NO: 

21P53380BR0BE 

Area 

5: 

id 

(sw) 

Vendor : 

IBM 

Serial 

NO: 

21P53380BS18A 

Area 

6: 

id 

(sw) 

Vendor : 

IBM 

Serial 

NO: 

21P53380BS170 

Area 

7  : 

id 

(sw) 

Vendor : 

IBM 

Serial 

NO  : 

21P53380BS26B 

Area 
Area 
Area  10 
Area  11 
Area  12 
Area  13 
Area  14 
Area  15 
Area  16 
( output 


9: 


id  (sw)  Vendor: 
truncated) 


AGILENT 


Serial  No:  0105091301045274 
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To  display  detailed  SFP  information  for  a  Finisar  smart  SFP: 


switch :user> 

sfpshow  1/3 

Identifier : 

3 

SFP 

Connector : 

7 

LC 

Transceiver : 

050c4 

0200000000 

0  100,200_MB/s  M5,M6  sw  Inter_dist 

Encoding : 

1 

8B10B 

Baud  Rate : 

21 

(units  100 

megabaud) 

Length  9u: 

0 

(units  100 

meters ) 

Length  50u: 

30 

(units  10 

meters ) 

Length  62 . 5u : 

;  15 

(units  10 

meters ) 

Length  Cu : 

0 

(units  1  meter) 

Vendor  Name : 

FINISAR  CORP. 

Vendor  OUI : 

00:90 

:  65 

Vendor  PN: 

FTRJ- 

8519-7D-2 . 

5 

Vendor  Rev : 

Options : 

0012 

Loss_of_Si 

g , Tx_Di sable 

BR  Max: 

0 

BR  Min: 

0 

Serial  No: 

H11QET9 

Date  Code: 

02042 

9 

Temperature : 

50  Centigrade 

Current : 

10634 

mAmps 

Voltage : 

3164  . 

8  mVolts 

RX  Power: 

199  .  6 

uWatts 

TX  Power: 

235.2 

uWatts 
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To  display  all  SPF  information: 


switch: user > 

sfpshow  -all 

Port     0 : 

Identifier : 

3  SFP 

Connector : 

7  LC 

Transceiver : 

050c402000000000  100,200_MB/s  M5,M6  sw  Inter_dist 

Encoding : 

1  8B10B 

Baud  Rate: 

21       (units  100  megabaud) 

Length  9u: 

0         (units  km) 

Length  9u: 

0         (units  100  meters) 

Length  50u: 

30       (units  10  meters) 

Length  62 . 5u ; 

:15       (units  10  meters) 

Length  Cu : 

0         (units  1  meter) 

Vendor  Name : 

IBM 

Vendor  OUI : 

08:00:5a 

Vendor  PN: 

IBM42P21SNY 

Vendor  Rev: 

AA10 

Wavelength : 

0         (units  nm) 

Options : 

001a  Loss_of_Sig, Tx_Fault , Tx_Disable 

BR  Max: 

5 

BR  Min: 

5 

Serial  No: 

21P7053164529 

Date  Code: 

01060501 

(output  truncated) 

See  also 

switchShow 
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shellFlowControlDisable 

Disables  XON/XOFF  flow  control  on  the  console  serial  ports. 

Synopsis 

shell flowcontroldi sable 

Availability 

admin 

Description 

Use  this  command  to  disable  XON/XOFF  flow  control  on  the  console  serial  ports.  Flow  control  is 
disabled  by  default. 

Because  this  command  changes  the  flow  control  on  the  console  serial  port,  it  must  be  executed  from  a 
session  that  is  logged  in  from  the  console  serial  port.  This  command  cannot  run  from  a  telnet  session. 

This  setting  saves  in  the  configuration  database;  therefore,  persistent  across  reboots  and  power  cycles. 

On  dual  control  processor  (CP)  systems,  a  reboot  on  the  standby  CP  is  required  for  this  command  to  take 
effect.  No  action  is  required  on  the  active  CP. 

Operands 

none 

Examples 

To  disable  flow  control: 

switch : admin>  shellf 1 owe ontroldi sable 

Disabling  flowcontrol 

flow  control  is  now  disabled 

See  also 

shellFlowControlEnable 
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shellFlowControlEnable 

Enables  XON/XOFF  flow  control  to  the  shell  task. 

Synopsis 

shellf lowcontrol enable 


Availability 

admin 


Description 

Use  this  command  to  enable  XON/XOFF  flow  control  to  the  shell  task.  Flow  control  is  disabled  by 
default. 

Because  this  command  changes  the  flow  control  on  the  console  serial  port,  it  must  be  executed  from  a 
session  that  is  logged  in  from  the  console  serial  port.  This  command  cannot  run  from  a  telnet  session. 

This  setting  saves  in  the  configuration  database;  therefore,  persistent  across  reboots  and  power  cycles. 

On  dual  control  processor  (CP)  systems,  a  reboot  on  the  standby  CP  is  required  for  this  command  to  take 
effect.  No  action  is  required  on  the  active  CP. 


A CAUTION:  If  flow  control  is  enabled  and  if  the  console  output  is  suspended  for  an  extended  period  of 
time,  the  switch  might  reboot.  HP  recommends  disabling  the  flow  control,  using 

shellFlowControlDi sable. 


Operands 

none 

Examples 

To  enable  flow  control: 

switch : admin>  shellf lowcontrolenable 

Enabling  flowcontrol 

flow  control  is  now  enabled 

See  also 

shellFlowControlDi sable 
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slotOff 

Disables  a  blade  slot. 


Synopsis 

slotoff  slotnumber 


Availability 

admin 


Description 

Use  this  command  to  disable  a  nonfaulty  blade  unit  while  leaving  the  blade  unit  powered  on. 

This  command  disables  both  the  external  and  internal  ports  on  the  blade,  in  contrast  to  the 
bladeDisable  command,  which  only  disables  external  ports.  Unlike  ports  affected  by 
bladeDisable,  ports  on  a  slot  disabled  by  this  command  are  not  re-enabled  after  switchEnable, 
switchStart,  or  switchReboot. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is 

required. 

Examples 

To  power  off  blade  unit  3: 

switch : admin>  slotoff  3 
Slot  3  is  being  disabled. 


See  also 

bladeDisable 

slotOn 

slotShow 
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slotOn 

Enables  a  blade  slot. 

Synopsis 

sloton  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  reenable  a  blade  unit  that  was  previously  disabled. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  enable.  This  operand  is  required. 

Examples 

To  power  on  blade  unit  3: 

switch: admin>  sloton  3 
Slot  3  is  being  enabled. 

See  also 

slotOf f 
slotShow 
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slotPowerOff 

Removes  power  from  a  slot. 

Synopsis 

slotpoweroff  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  turn  off  the  power  to  a  blade  unit.  The  slot  must  have  a  valid  blade  unit  present  and 
the  blade  unit  must  be  of  a  type  that  can  be  powered  off. 

Operands 

This  command  has  the  following  operand: 

slotnumber       Specify  the  slot  number  of  the  blade  to  disable.  This  operand  is  required. 

Examples 

To  power  off  blade  unit  3: 

switch : admin>  slotpoweroff  3 
Slot  3  is  being  powered  off 

See  also 

powerOff List Set 
powerOf f Li st Show 
slotPowerOn 
slotShow 
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slotPowerOn 

Restores  power  to  a  slot. 

Synopsis 

slotpoweron  slotnumber 

Availability 

admin 

Description 

Use  this  command  to  turn  on  the  power  to  a  blade  unit.  The  slot  must  have  a  valid  blade  unit  present  and 
the  blade  unit  must  be  currently  powered  off.  The  slotShow  command  reports  such  slots  as  being  in  the 
state  of  INSERTED,  NOT  POWERED  ON. 

Operands 

This  command  has  the  following  operand: 

slotnumber  Specify  the  slot  number  of  the  blade  to  enable.  This  operand  is  required. 

Examples 

To  power  on  blade  unit  3: 

switch : admin>  slotpoweron  3 
Powering  on  slot  3 . 


See  also 

slotOn 

slotPowerOf f 
slotShow 
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slotShow 


Displays  the  status  of  all  slots  in  the  system. 


Synopsis 


slotshow 


Availability 

all  users 

Description 

Use  this  command  to  inventory  and  display  the  current  status  of  each  slot  in  the  system.  The  fields  and 
their  possible  values  are  as  follows: 


Slot 

Blade  Type 


ID 

Status 


Displays  the  physical  slot  number. 
Displays  the  blade  type: 

SW  BLADE-The  blade  is  a  switch. 

CP  BLADE— The  blade  is  a  control  processor. 

UNKNOWN— Blade  not  present  or  its  type  is  not  recognized 
Displays  the  hardware  ID  of  the  blade  type. 
Displays  the  status  of  the  blade: 

VACANT— The  slot  is  empty. 

INSERTED,  NOT  POWERED  ON-The  blade  is  present  in  the  slot  but  is  turned 
off. 

DIAG  RUNNING  POST1  —The  blade  is  present,  powered  on,  and  running  the 
POST  (power-on  self-test). 

DIAG  RUNNING  POST2— The  blade  is  present,  powered  on,  and  running  the 
POST  (power-on  self-test). 

ENABLED— The  blade  is  on  but  the  external  ports  are  disabled  using 

bladeDi sable. 

DISABLED— The  blade  is  powered  on  but  disabled. 
FAULTY— The  blade  is  faulty  because  an  error  was  detected. 
UNKNOWN— The  blade  is  inserted  but  its  state  cannot  be  determined. 


Operands 


none 
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Examples 

To  display  a  blade  inventory  and  status: 


switch 

: admin>  slotshow 

Slot 

Blade  Type 

ID 

Status 

1 

SW  BLADE 

2 

FAULTY 

2 

SW  BLADE 

2 

DISABLED 

3 

SW  BLADE 

2 

ENABLED 

4 

SW  BLADE 

2 

DIAG  RUNNING  POST2 

5 

CP  rJLAUhi 

ENABLED  (User  Ports  Disabled) 

6 

CP  BLADE 

1 

ENABLED 

7 

UNKNOWN 

VACANT 

8 

SW  BLADE 

2 

DIAG  RUNNING  POSTl 

9 

SW  BLADE 

2 

INSERTED,    NOT   POWERED  ON 

10 

UNKNOWN 

VACANT 

See  also 

bladeDi sable 
bladeEnable 
chassisShow 
slotOf f 
slotOn 

slotPowerOf f 
slotPowerOn 
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slTest 


Tests  the  serial  link  of  port  N->N  path. 


Synopsis 


sltest  [  -ports  itemlist  ] [  -lb_mode  mode  ] [  -speed  mode  ] 
[   -passcnt  count  ] [   -duration  count  ] 


Availability 


admin 


Description 


Use  this  command  to  verify  the  intended  functional  operation  of  the  switch  by  sending  SERDES  BIST 
patterns  from  port  N's  transmitter,  and  looping  the  patterns  back  into  the  same  port  N's  receiver.  The 
loopback  is  done  at  the  parallel  and  serial  loopback  paths.  The  path  exercised  in  this  test  can  include  the 
media  or  the  fiber  cable. 

The  test  patterns  are  transmitted  and  received  continuously  during  the  test  duration.  An  external  cable  is 
optional  to  run  this  test. 

The  test  method  is  as  follows: 

1.  Set  all  ports  present  for  one  of  the  following  modes:  parallel,  SERDES  pads,  or  external  cable 
loopback. 

2.  Program  the  port  to  repeatedly  send  predefined  LPE. 

3.  Verify  the  primitive  is  received  at  the  same  port. 

4.  Check  the  receive  port  for  possible  code  violation  on  nonframe  data  or  BadOrdSet. 

5.  Repeat  step  2  through  step  4  for  all  ports  present  until: 

a.  The  number  of  -passcnt  count  requested  is  reached. 

b.  All  ports  are  marked  bad. 


Operands 


The  optional  operands  are  as  follows: 


-lb_mode  mode 


Sets  the  loopback  point  for  the  test.  By  default,  slTest  uses  internal 
loopback.  Available  modes  are  as  follows: 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 
5  Internal  (parallel)  loopback 

7  Backend  bypass  and  port  loopback 

8  Backend  bypass  and  SERDES  loopback 

9  Backend  bypass  and  internal  loopback 


■passcnt  count 


■speed  mode 


Specifies  the  speed  mode  for  the  test.  Available  modes  are  as  follows: 

1  Runs  the  test  at  both  1  Gb/s 

2  Sets  and  locks  all  port  speeds  to  2  Gb/s 

3  Sets  and  locks  all  port  speeds  to  3  Gb/s 

4  Sets  and  locks  all  port  speeds  to  4  Gb/s  (default) 
Specifies  the  number  of  times  to  perform  this  test.  The  default  value  is  1 . 
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-duration  count  Specifies  the  duration,  in  milliseconds,  to  perform  this  test  on  the 

primitive.  The  default  value  is  100. 

--ports  itemlist        Specifies  a  list  of  blade  ports  to  test.  By  default  all  the  blade  ports  in  the 

specified  slot  (-slot)  is  used.  See  itemList  for  further  details. 

Examples 

To  test  the  serial  link  of  the  following  port  path: 

switch: admin>  sltest  -ports  0/5-0/31  -speed  4  -lb_mode  1  passcnt  1 

Running  Port  sltest  .... 

passed. 

Diagnostic 

When  it  detects  failures,  the  test  might  report  one  or  more  of  the  following  error  messages: 

DATA 

ERRSTAT 

INIT 

STATS 

TIMEOUT 

See  also 

cmemRetentionTest 

crossPortTest 

itemList 

portRegTest 

spinSilk 
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snmpConfig 


Manages  the  SNMP  agent  configuration. 


Synopsis 

snmpConfig  --show  |  --set  |  --default  [snmpvl  |  snmpv3  |  accessControl 
mibCapability   |  systemGroup] 

Availability 

admin  (set,  default) 


Use  this  command  to  manage  the  configuration  of  the  SNMP  agent  in  the  switch.  The  configuration 
includes  SNMPvl  and  SNMPv3  configuration,  access  control  list  (ACL)  configuration,  MIB  capability 
configuration,  and  system  group  configuration.  It  supports  set,  reset  to  default,  and  display  operations. 

If  you  issue  this  command  with  incomplete  parameters,  it  displays  the  command  usage. 

All  values  successfully  changed  by  this  command  take  effect  immediately  and  are  persistent  across  power 
cycles  and  reboots.  For  dual-domain  systems,  this  command  is  specific  to  the  SNMP  agent  associated 
with  the  current  switch. 


There  are  six  communities,  respective  trap  recipients,  and  trap  recipient  severity  levels  supported  by  the 
agent.  The  first  three  communities  are  for  read-write  (rw)  access  and  the  last  three  are  for  read-only  (ro) 
access.  The  default  value  for  the  trap  recipient  of  each  community  is  0.0.0.0.  The  length  of  community 
string  should  be  in  range  of  2  to  1 6  characters.  The  default  values  for  the  community  strings  are: 

Community  1 :  Secret  COde 

Community  2:  OrigEquipMfr 

Community  3:  private 

Community  4:  public 

Community  5:  common 

Community  6:  FibreChannel 


NOTE:  When  secure  mode  is  enabled,  community  strings  can  be  changed  on  the  primary  FCS  switch 
only  and  propagate  changes  across  the  fabric. 


For  an  SNMP  management  station  to  receive  a  trap  generated  by  the  agent,  the  administrator  must 
configure  a  trap  recipient  to  correspond  to  the  IP  address  of  the  management  station.  In  addition,  the  trap 
recipient  must  be  able  to  pass  the  ACL  check,  as  described  in  "accessControl  configuration  parameters" 
on  page  641 . 

Trap  recipient  severity  level 

The  event  trap  level  works  in  conjunction  with  an  event's  severity  level.  When  an  event  occurs,  if  its 
severity  level  is  at  or  below  the  set  value,  the  SNMP  traps,  and  event  traps  (swEventTrap, 


all  users  (display) 


Description 


SNMPvl  configuration  parameters 
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connUnitEventTrap,  and  swFabricWatchTrap),  are  sent  to  configured  trap  recipients.  By  default,  this 
value  is  set  at  0,  implying  that  no  Event  Trap  is  sent.  Possible  values  are: 


0 

None 

1 

Critical 

2 

Error 

3 

Warning 

4 

Informationa 

5 

Debug 

SNMPv3  configuration  parameters 

Two  user  roles,  snmpadmin  and  snmpuser,  are  supported,  snmpadmin  provides  read-write  access  and 
snmpuser  provides  read-only  access.  Entries  are  added  to  USM  table  corresponding  to  each  role.  A  total 
of  three  entries  of  role  snmpadmin  and  three  entries  of  role  snmpuser  are  supported.  Separate  default 
passwords  are  provided  for  creation  of  authKey  and  privKey  for  each  entry.  A  default  set  of  passwords  is 
published  and  a  default  algorithm  (MD5/SHA)  is  used  to  create  initial  set  of  auth  keys.  You  can  change 
these  passwords  using  this  option.  You  have  the  option  to  select  authentication  protocol  MD5/SHA  or  no 
authentication  for  each  entry. 

Select  the  following  combination  of  protocols: 

NoAuth/NoPriv 

Auth/NoPriv 

Auth/Priv 

The  length  of  the  user  name  string  should  be  in  range  of  2  to  32  characters.  Note  that  the  default  user 
names  are  defined  with  the  noAuth  and  noPriv  protocol.  The  factory  default  SNMPv3  user  names  are: 

User  1 :  snmpadmin! 

User  2:  snmpadmin2 

User  3:  snmpadmin3 

User  4:  snmpuserl 

User  5:  snmpuser2 

User  6:  snmpuser3 

The  user  configuration  is  available  in  both  the  secure  and  nonsecure  mode.  When  the  user  selects  the 
—default  option,  the  user  name  and  passwords  are  set  to  default. 

In  secure  mode,  the  above  configuration  has  to  be  updated  by  the  user  on  both  primary  and  nonprimary 
switches  individually.  Unlike  community  strings,  the  user  name  and  passwords  are  not  distributed  for 
other  switches  in  the  fabric. 

When  new  passwords  are  entered  for  any  user  entry,  new  authKey  and  privKey  are  generated.  The 
administrator  must  update  the  new  passwords  on  the  client  (such  as  a  MIB  browser)  also.  AuthKey  and 
privKey  can  also  be  updated  using  delta  key  mechanism  provided  by  SNMPv3  protocol. 

You  are  prompted  for  the  password  and  for  re-confirmation  of  the  password,  if  any  protocol  is  selected 
other  than  NoAuth/NoPriv.  The  length  of  protocol  passwords  should  be  in  range  of  1  to  20  characters. 

Note  that  in  order  for  an  SNMP  management  station  to  receive  SNMPv3  traps  generated  by  the  agent, 
the  administrator  must  configure  a  trap  recipient  value  to  correspond  to  the  IP  address  of  the  management 
station.  Also,  the  trap  recipient  should  be  able  to  pass  the  ACL  check,  as  described  in  "accessControl 
configuration  parameters"  on  page  641 .  The  trap  recipient  value  should  be  associated  with  one  of  the 
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six  users  of  SNMPv3  and  trap  severity  level.  Note  that  the  factory  default  value  for  the  SNMPv3  trap 
recipient  of  each  user  is  0.0.0.0. 


accessControl  configuration  parameters 

The  ACL  check  is  as  follows:  there  are  six  ACLs  to  restrict  SNMP  get/set/trap  operations  to  hosts  under  a 
host-subnet-area.  Host-subnet-area  is  defined  by  comparing  nonzero  IP  octets.  For  example,  an  ACL  of 
1 92.1 68.64.0  enables  access  by  any  host  that  starts  with  the  specified  octets.  The  connecting  host  is 
enabled  to  set  each  host-subnet-area  to  be  read-write  or  read-only.  The  highest  privilege  matched  out  of 
six  entries  is  given  access.  The  ACL  check  is  turned  off  when  all  six  entries  contain  0.0.0.0.  The  default 
values  of  all  six  entries  are  0.0.0.0. 


NOTE:  When  secure  mode  is  enabled,  the  Access  Control  List  feature  is  incorporated  into  the  WSNMP 
and  RSNMP  security  policies. 


mibCapability  configuration  parameters 

This  mibCapability  option  turns  on  or  off  certain  MIBs  and  traps. 


r)-Mr 


NOTE:    The  agtCf  gDef  ault  command  also  resets  the  SNMP  MIB  and  trap  capability  to  default  with 
other  SNMP  agent  configuration. 

If  SNMP  MIB  is  disabled,  then  corresponding  traps  also  are  disabled.  If  any  trap  group  is  disabled,  then 
corresponding  individual  traps  also  are  disabled. 

The  FE  and  SW  MIBs  are  always  accessible.  snmpMibCapSet  does  not  prompt  you  to  turn  these  MIBs 
on  or  off. 


mibCapability  configuration  parameters  include  the  following: 

FA-MIB  Specifying  yes  means  the  user  can  access  FA-MIB  variables  with  an  SNMP 

manager.  The  default  value  is  yes. 

FICON-MIB  Specifying  yes  means  the  user  can  access  FICON-MIB  variables  with  an  SNMP 

manager.  The  default  value  is  yes. 

HA-MIB  Specifying  yes  means  the  user  can  access  Entity-MIB  and  HA-MIB  variables  with  an 

SNMP  manager.  The  default  value  is  yes. 

SW-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 

from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual 
SW  traps.  The  individual  SW  traps  are  swFCPortScn,  swEventTrap, 
swFabricWatchTrap,  and  swTrackChangesTrap. 

FA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 

from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual 
FA  Traps.  The  individual  FA  Traps  are  connUnitStatusChange,  connUnitEventTrap, 
connUnitSensorStatusChange,  and  connUnitPortStatusChange. 

SW-EXTTRAP        Specifying  yes  means  the  user  can  receive  an  SSN  in  the  SW  traps.  The  default 
value  is  no. 

FICON-TRAP        Specifying  yes  means  the  SNMP  management  application  can  receive  FICON 
traps  from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off 
individual  FICON  Traps.  The  individual  FICON  Traps  are 

linkRNIDDeviceRegistration,  linkRNIDDeviceDeRegistration,  linkLIRRListenerAdded, 
linkLIRRListenerRemoved  and  linkRLIRFailurelncident. 

HA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  HA  traps 

from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  HA 
Traps.  The  individual  HA  Traps  are  fruStatusChanged,  cpStatusChanged,  and 
fruHistoryTrap. 
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systemGroup  configuration  parameters 


sysDescr 

sysLocation 

sysContact 

authTraps 


System  description.  The  default  value  is  Fibre  Channel  Switch. 

Location  of  the  system  (switch).  The  default  value  is  End  User  Premise. 

Contact  information  for  this  system  (switch).  The  default  value  is  set  as  Field 
Support.  See  the  definition  of  sysDescr,  sysLocation,  and  sysContact  in 
system  group  of  MIB-II. 

When  enabled,  the  authentication  trap  (authenticationFailure)  is  transmitted  to 
a  configured  trap  recipient  in  the  event  that  the  agent  received  a  protocol 
message  that  is  not  properly  authenticated.  In  the  context  of  SNMPvl  and 
SNMPv2c,  this  means  that  a  request  contains  a  community  string  that  is  not 
known  to  the  agent.  The  default  value  for  this  parameter  is  0  (disabled). 


Operands 


This  command  supports  the  following  operands: 


--show 
--set 

--default 


Displays  the  SNMP  agent  configuration  data  of  the  specified  category. 

Sets  the  SNMP  agent  configuration  data  of  the  specified  category.  This 
operand  displays  the  current  settings,  and  then  prompts  you  to  change  the 
values  for  each  parameter. 

Sets  the  SNMP  agent  configuration  data  for  a  specified  item  to  the  default 
values.  Generally,  these  default  values  might  be  available  in  the  configuration 
database.  Factory  default  settings  are  set  if  the  SNMP  agent  configuration 
parameters  are  not  available  in  the  configuration  database. 


-show,  --set,  and  --default  support  the  following: 


snmpvl 


snmpv3 


accessControl 


mibCapability 


systemGroup 


Selects  SNMPvl -related  configuration  parameters.  SNMPvl  parameters 
include  the  community  string,  trap  recipient  IP  address,  and  trap  severity  level 
associated  with  each  trap  recipient  IP  address. 

Selects  SNMPv3-related  configuration  parameters.  SNMPv3  parameters 
include  user  name,  authentication  protocol  and  password,  SNMPv3  trap 
recipients  IP  address,  associated  user  index,  and  trap  severity  level. 

Selects  access-control-related  parameters.  accessControl  parameters  include 
access  host  subnet  area  and  access  permission  (read-write). 

Selects  configuration  parameters  related  to  the  SNMP  agent's  MIBs  and  trap 
capability  parameters.  mibCapability  parameters  include  MIBs  and  traps 
supported  by  the  SNMP  agent. 

Selects  configuration  parameters  related  to  the  system  group.  systemGroup 
parameters  include  sysDescr,  sysLocation,  sysContact,  and  authentication 
failure  trap. 
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Examples 

To  change  the  SNMPvl  configuration: 


switch : admin>  snmpconfig  --set 

snmpvl 

SNMP  community 

and  trap  recipient  i 

configuration : 

Community  (rw) 

:    [Secret  COde]  admin 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[0. 

0.0. 

.0] 

10  .32 .225 . 1 

Trap  recipient 

Severity  level  : 

:  (0 

..5)    [0]  1 

Community  (rw) 

:    [OrigEquipMf r] 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.2] 

Trap  recipient 

Severity  level  ; 

:  (0 

..5)  [1] 

Community  (rw) 

:  [private] 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.3] 

Trap  recipient 

Severity  level  ; 

:  (0 

..5)  [2] 

Community  (ro) 

:  [public] 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[10 

.32 

.225 

.4] 

Trap  recipient 

Severity  level  : 

:  (0 

..5)  [3] 

Community  (ro) 

:  [common] 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[10 

.32  . 

.225 

.5] 

Trap  recipient 

Severity  level  : 

:  (0 

..5)  [4] 

Community  (ro) 

:  [FibreChannel] 

Trap  Recipient 

' s  IP  address  in 

dot 

notation : 

[10 

.32. 

.225 

.6] 

Trap  recipient 

Severity  level  ; 

:  (0 

..5)  [5] 

Committing  configuration ...  done . 
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To  change  the  SNMPv3  configuration: 


switch: admin>  snmpconfig  --set  snmpv3 

SNMPv3  user  configuration: 

User   (rw) :    [ snmpadminl ]  adminuser 

Auth  Protocol    [MD5 ( 1 ) /SHA ( 2 ) /noAuth ( 3 ) ] : 

(1. 

3) 

[3] 

1 

New  Auth  Passwd: 

Verify  Auth  Passwd: 

Priv  Protocol    [DES ( 1 ) /noPriv [2 ] ) :  (1..2) 

[2] 

1 

New  Priv  Passwd: 

Verify  Priv  Passwd: 

User   (rw) :    [ snmpadmin2 ]  shauser 

Auth  Protocol    [MD5 ( 1 ) /SHA ( 2 ) /noAuth ( 3 ) ] : 

(1. 

3) 

[3] 

2 

New  Auth  Passwd: 

Verify  Auth  Passwd: 

Priv  Protocol    LDES ( 1 J / noPriv  L  2  J  )  :    ( 1 .  .  2  ) 

[2] 

1 

New  Priv  Passwd: 

Verify  Priv  Passwd: 

User   (rw)  :    [ snitipadmin3  ]  nosec 

Autn  Protocol    LMD5 ( 1 ) / SHA ( 2 ) /noAutn ( 3 ) J : 

(1. 

3) 

[3] 

Priv  Protocol    [DES ( 1 ) /noPriv [ 2 ])  :    (2..  2) 

[2] 

User   (ro) :  [snmpuserl] 

Auth  Protocol    [MD5 ( 1 ) /SHA ( 2 ) /noAuth ( 3 ) ] : 

(3. 

3) 

[3] 

Priv  Protocol    LDES ( 1 ) / noPriv  L  2  J )  :    ( 2  .  .  2 ) 

[2] 

User   (ro) :  [snmpuser2] 

Auth  Protocol    [MD5 (1) /SHA (2) /noAuth (3) ] : 

(3  . 

3) 

[3] 

Priv  Protocol    LDES ( 1 ) / no Priv  L 2  J )  :    ( 2  .  .  2 ) 

[2  ] 

User   (ro) :  [snmpuser3] 

Auth  Protocol    [MD5 (1) /SHA (2) /noAuth (3) ] : 

(3  . 

3) 

[3] 

Priv  Protocol    [DES ( 1 ) /noPriv [ 2 ])  :    (2.. 2) 

[2] 

SNMPv3  trap  recipient  configuration: 

192 

Trap  Recipient's  IP  address  in  dot  notation: 
168.45.90 

[0 

0  .  0 

0] 

Userlndex:    (1 . . 6)  [1] 

Trap  recipient  Severity  level   :    (0..5)    [0]  4 

192 

Trap  Recipient's  IP  address  in  dot  notation: 
168.45.92 

[0 

0  .  0 

0] 

Userlndex:    (1. .6)  [2] 

Trap  recipient  Severity  level   :    (0..5)    [0]  2 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0.0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0  .  0 

0] 

Trap  Recipient's  IP  address  in  dot  notation: 

[0 

0.0 

0] 

Committing  configuration ...  done . 
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To  change  the  accessControl  configuration: 


switch : admin>  snmpconfic 

j  --set  accessControl 

SNMP  access 

list  configuration: 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

192 

.168.0 

0 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

10. 

32  . 148 

0 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

f 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

10. 

33.0.0 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

f 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

Access  host 

subnet 

area  in  dot  notation 

[0 

0 

0 

0] 

Read/Write? 

(true, 

t,   false,   f ) :  [true] 

Committing 

configuration. . .done. 

To  display  the  mibCapability  configuration: 


switch : admin>  snmpconfig  --show  mibCapability 
FE-MIB:  YES 
SW-MIB:  YES 
FA-MIB:  YES 
FICON-MIB:  YES 
HA-MIB :  YES 
SW-TRAP:  YES 

swFCPortScn:  YES 

swEventTrap :  YES 

swFabricWatchTrap :  YES 

swTrackChangesTrap :  NO 
FA-TRAP :  YES 

connUnitStatusChange :  YES 

connUnitEventTrap :  NO 

connUnitSensorStatusChange :  YES 

connUnitPortStatusChange :  YES 
SW-EXTTRAP:  NO 
FICON-TRAP:  NO 
HA-TRAP :  YES 

fruStatusChanged:  YES 

cpStatusChanged:  YES 

f ruHistoryTrap :  NO 
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To  change  the  systemGroup  configuration  to  the  default: 

switch: admin>  snmpconfig  --default  systemGroup 

This  command  will  reset  the  agent's  system  group  configuration  back 
to  factory  default 

sysDescr  =  Fibre  Channel  Switch 
sysLocation  =  End  User  Premise 
sysContact  =  Field  Support 
authTraps  =  0  (OFF) 

•k  k  ic  *  Jf 

Are  you  sure?    (yes,   y,   no,   n) :    [no]  y 

See  also 

agtCfgDefault 
agtCfgSet 
agtCf gShow 
snmpMibCapSet 
snmpMibCapShow 

SW_v5_x.mib,  Switch  Management  Information  &  Switch  Enterprise  Specific  Trap 
RFC!  157,  A  Simple  Network  Management  Protocol  (SNMPvl) 

RFC! 21 3,  Management  information  Base  for  Network  Management  of  TCP/IP-based  internets:  MIB-II 

RFC2574,  User-based  Security  Model  (USM)  for  version  3  of  the  Simple  Network  Management  Protocol 
(SNMPv3) 
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snmpMibCapSet 


Modifies  options  for  configuring  SNMP  MIB  trap  capability. 

Synopsis 

snmpmibcapset 

Availability 

admin 


Description 

This  command  enables  a  user  to  turn  on  or  off  certain  MIBs  and  traps.  This  command  also  enables  a  user 
to  turn  on  or  off  group  information  and  SSN  in  SW  trap  messages.  It  first  displays  current  settings  and 
then  prompts  the  user  to  change  the  values  for  each  parameter. 

FA-MIB  Specifying  yes  means  the  user  can  access  FA-MIB  variables  with  an  SNMP 

manager.  The  default  value  is  yes. 

HA-MIB  Specifying  yes  means  the  user  can  access  Entity-MIB  and  HA-MIB  variables  with  an 

SNMP  manager.  The  default  value  is  yes. 

SW-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 

from  the  switch.  The  default  value  is  yes. 

FA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 

from  the  switch.  The  default  value  is  yes. 

SW-EXTTRAP       Specifying  yes  means  the  SNMP  management  application  can  receive 
SW-EXTTRAPS  from  the  switch.  The  default  value  is  yes. 

HA-TRAP  Specifying  yes  means  the  SNMP  management  application  can  receive  HA-TRAPS 

from  the  switch.  The  default  value  is  yes. 


Operands 

none 
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Example 

To  view  or  modify  the  options  for  configuring  SNMP  MIB  traps: 


switch : admin>  snmpmibcapset 

The  SNMP  Mib/Trap  Capability  has  been  set  to  support 

FE-MIB 

SW-MIB 

FA-MIB 

FICON-MIB 

HA-MIB 

SW-TRAP 

swFCPortScn 

swFabricWatchTrap 

FA-TRAP 

connUnitStatusChange 
connUnitSensorStatusChange 

HA-TRAP 

f ruStatusChanged 
cpStatusChanged 

FA-MIB   (yes,  y,   no,   n) :  [yes] 

FICON-MIB   (yes,   y,   no,   n) :    [yes]  n 

HA-MIB   (yes,  y,   no,   n) :  [yes] 

SW-TRAP   (yes,   y,   no,   n) :  [yes] 

swFCPortScn   (yes,   y,   no,   n) :  [yes] 
swEventTrap   (yes,   y,   no,   n) :  [no] 
swFabricWatchTrap  (yes,  y,  no,  n) :  [yes] 
swTrackChangesTrap   (yes,  y,   no,   n) :    [no]  y 

FA-TRAP   (yes,   y,   no,   n) :    [yes]  n 

SW-EXTTRAP   (yes,   y,   no,   n) :  [no] 

HA-TRAP   (yes,   y,   no,   n) :  [yes] 

f ruStatusChanged   (yes,  y,   no,   n) :  [yes] 
cpStatusChanged   (yes,   y,   no,   n) :  [yes] 
f ruHistoryTrap   (yes,  y,   no,   n) :  [no] 

See  also 

agtCfgDefault 
agtCfgSet 
agtCf gShow 
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snmpMibCapShow 


Displays  options  for  configuring  SNMP  MIB  trap  capability. 


Synopsis 


snmpMibCapShow 


Availability 

all  users 


Description 

Use  this  command  to  display  the  SNMP  MIBs  and  traps  capability  of  the  SNMP  agent  in  the  switch. 


FA-MIB 


FICON-MIB 


HA-MIB 


SW-TRAP 


FA- TRAP 


SW-EXTTRAP 
FICON-TRAP 


HA-TRAP 


Specifying  yes  means  the  user  can  access  FA-MIB  variables  with  an  SNMP 
manager.  The  default  value  is  yes. 

Specifying  yes  means  the  user  can  access  FICON-MIB  variables  with  an  SNMP 
manager.  The  default  value  is  yes. 

Specifying  yes  means  the  user  can  access  Entity-MIB  and  HA-MIB  variables  with  an 
SNMP  manager.  The  default  value  is  yes. 

Specifying  yes  means  the  SNMP  management  application  can  receive  SW-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  SW 
Traps.  The  individual  SW  traps  are  swFCPortScn,  swEventTrap,  swFabricWatchTrap 
and  swTrackChangesTrap. 

Specifying  yes  means  the  SNMP  management  application  can  receive  FA-TRAPS 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  FA 
Traps.  The  individual  FA  Traps  are  connUnitStatusChange,  connUnitEventTrap, 
connUnitSensorStatusChange  and  connUnitPortStatusChange. 

Specifying  yes  means  user  can  receive  SSN  in  the  SW  traps.  The  default  value  is  no. 

Specifying  yes  means  the  SNMP  management  application  can  receive  FICON  traps 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual 
FICON  Traps.  The  individual  FICON  Traps  are  linkRNIDDeviceRegistration, 
linkRNIDDeviceDeRegistration,  linkLIRRListenerAdded,  linkLIRRListenerRemoved  and 
linkRLIRFailurelncident. 

Specifying  yes  means  the  SNMP  management  application  can  receive  HA  traps 
from  the  switch.  The  default  value  is  yes.  Users  can  also  turn  on  or  off  individual  HA 
Traps.  The  individual  HA  Traps  are  fruStatusChanged,  cpStatusChanged,  and 
fruHistoryTrap. 


NOTE:     agtCf gDef ault  also  resets  the  SNMP  MIB  and  trap  capability  to  default  along  with  other 
b_ I    SNMP  agent  configuration. 

The  values  can  be  changed,  if  user  download  the  configuration  data  through  conf  igDownload 
command. 

All  the  new  values  successfully  configured  by  snmpMibCapSet  command  takes  effect  immediately. 
If  SNMP  MIB  is  disabled,  then  the  corresponding  traps  are  disabled.  If  any  trap  group  is  disabled  then 
the  corresponding  individual  traps  also  are  disabled. 

The  FE  and  SW  MIBs  always  are  accessible.  snmpMibCapSet  does  not  prompt  the  user  to  turn  on  or  off 
these  MIBs. 


Operands 

none 
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Examples 

To  display  the  options  for  configuring  SNMP  MIB  trap  capability: 

switch : admin>  snmpmibcapshow 

FE-MIB:  YES 
SW-MIB:  YES 
FA-MIB:  YES 
FICON-MIB:  NO 
HA-MIB :  YES 
SW-TRAP:  YES 

swFCPortScn:  YES 

swEventTrap :  NO 

swFabricWatchTrap :  YES 

swTrackChangesTrap :  YES 
FA-TRAP :  NO 
SW-EXTTRAP:  NO 
HA-TRAP:  YES 

fruStatusChanged:  YES 

cpStatusChanged:  YES 

f ruHistoryTrap :  NO 

See  also 

agtCfgDefault 
agtCfgSet 
agtCf gShow 
snmpConf ig 
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spinFab 

Runs  functional  test  of  switch-to-switch  ISL  cabling  and  trunk  group  operation. 


Synopsis 

spinfab   [-nmegs  count]  [-ports  itemlist]  [-setfail  mode]  [-domain  value] 


Availability 

admin 

Description 

Use  this  command  to  verify  the  intended  functional  operation  of  the  ISL  links  between  switches.  At  the 
maximum  speed  of  4  Gb/s,  it  sets  the  routing  hardware  such  that  test  frames  received  by  each  E_Port  are 
retransmitted  on  the  same  E  Port.  Next,  it  sends  several  frames  to  the  neighbor  port  attached  to  each 
active  E_Port  specified.  The  default  action  for  such  frames  is  to  route  them  back  to  the  sender,  which 
never  occurs  for  normal  traffic.  The  frames  circulate  until  the  test  stops  them. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running.  While  the  frames  are  circulating,  the  RX  frame  count  and  port  CRC  and 
encoder  error  statistics  are  monitored  and  errors  will  be  generated  if  a  port  stops  or  a  low-level  error 
occurs.  Every  one  million  frames,  the  circulating  frames  are  captured  to  verify  that  they  are  still  circulating 
and  that  they  are  still  in-order.  In  this  manner,  the  entire  path  to  the  remote  switch  might  be  verified,  as 
can  be  the  proper  in-order  delivery  operation  of  any  trunk  groups  present. 

The  switch  remains  in  normal  operation  while  this  test  is  running;  however,  some  performance 
degradation  occurs  due  to  the  ISL  links  being  saturated  with  test  frames.  Because  of  this,  you  should  use 
caution  when  running  this  test  on  live  fabrics.  Consider  only  testing  one  trunk  group  or  ISL  link  at  a  time, 
and  do  not  run  the  tests  for  extended  periods  of  time. 

This  test  is  best  combined  with  the  online  crossPortTest  for  ISL  link-failure  isolation.  If  this  test  fails, 
replace  the  cable  with  a  loop-back  plug  and  run  crossPortTest  to  verify  the  local  switch  and  media. 
If  these  pass,  the  fault  lies  in  the  cable  or  remote  switch  and  media. 

The  frames  are  continuously  transmitted  and  received  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running. 


2^>?  NOTE:   When  trunk  groups  are  present,  the  entire  trunk  group  must  be  included  in  the  range  of  ports  to 
test  or  false  failures  can  occur.  If  multiple  ISL  links  are  present  between  two  switches  that  support  trunking, 
then  it  is  likely  that  trunk  groups  are  present  and  all  ports  between  the  two  switches  should  be  tested  at 
the  same  time. 
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Operands 


This  command  has  the  following  operands: 


-nmegs  count 


-ports  itemlist 


-setfail  mode 


-domain  value 


Specify  in  millions  the  number  of  frames  to  send.  The  test  will  progress 
until  the  specified  number  of  frames  has  been  transmitted  on  each  port. 
The  default  value  is  10  million  frames. 

This  command  only  approximately  counts  the  frames  and  the  actual 
number  of  frames  sent  will  be  slightly  larger,  particularly  at  2  Gb/s  link 
speeds. 

Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  ISL  ports  in  the 
current  switch  will  be  tested.  See  itemList  help  pages  for  further 
details. 

Instruct  spinFab  how  to  mark  failed  ports.  If  set  to  1 ,  it  will  mark 
failing  ports  as  FAILED.  If  set  to  0,  it  will  not  mark  failed  ports  as 
FAILED.  It  is  to  minimize  the  impact  on  live  fabrics.  This  test  normally 
logs  errors  but  does  not  set  the  port  status  to  FAILED.  This  parameter  is 
provided  to  force  the  failing  ports  to  be  marked  as  FAILED  in  the  same 
manner  as  other  diagnostics.  In  test  or  qualification  environments 
without  live  traffic,  this  might  be  useful  with  large  values  of  -nmegs 
count.  This  mode  is  disabled  by  default. 

Specify  a  remote  domain  to  which  the  switch  is  connected.  The  default 
is  to  automatically  determine  the  remote  domain  number.  This  might  not 
work  properly  in  certain  conditions. 


Examples 


To  test  cascading  ISL  links: 


switch: admin>  spinfab  -ports  1/0  -  1/2 
spinfab  running. . . 

spinfab:  Completed  11  megs,   status:  passed. 


port  0  test  status:   0x00000000  -- 
port  1  test  status:   0x00000000  -- 
port  2  test  status:   0x00000000  -- 
Test  Complete:    "spinfab"  Pass  10  of  10 
Duration  0  hr,    0  min  &  41  sec  (0:0:41:877). 
passed. 


passed, 
passed, 
passed. 


Diagnostics 

When  it  detects  failures,  the  test  might  report  one  or  more  of  the  following  error  messages: 


DATA 

ERR_ 

STAT 

ERR_ 

STATS 

ERR_ 

.STATS. 

.2  LONG 

ERR_ 

.STATS. 

.BADEOF 

ERR_ 

.STATS. 

.BADOS 

ERR_ 

.STATS. 

.C3DISC 

ERR_ 

.STATS. 

_CRC 

ERR_ 

.STATS. 

.ENCIN 

ERR_ 

.STATS. 

.ENCOUT 

ERR_ 

.STATS. 

.TRUNC 
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ERR_STAT_2  LONG 

ERR_STAT_BADEOF 

ERR_STAT_BADOS 

ERR_STAT_C3DISC 

ERR_STAT_CRC 

ERR_STAT_ENCIN 

ERR_STAT_ENCOUT 

ERR_STAT_TRUNC 

FINISH_MSG_ERR 

INIT 

MBUF_STATE_ERR 

NO_SEGMENT 

PORT_AB  S  ENT 

PORT_DIED 

PORT_ENABLE 

PORT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMemoryTest 
cmeraRe  tentionTest 
cmiTest 
crossPortTest 
itemList 

portLoopbackTest 
spinSilk 

sramRe tentionTest 
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spinJitter 


Measures  line-speed  jitter. 


Synopsis 

spinjitter  [--slot  number]  [-nmegs  count]  [-lb_mode  mode]  [ -spd_mode  mode] 
[-ports  itemlist] 


Availability 

admin 


Description 

This  test  uses  the  same  procedures  as  spinSilk  but  with  a  special  pattern  for  line-speed  jitter 
measurement.  The  test  uses  the  following  pattern: 

jCRPAT      be  d7  23  47  6b  8f  b3  14  5e  fb  35  59  be  d7  23  47 
For  details  about  the  procedures  used  in  this  test,  see  spinSilk. 


Options 


The  following  are  optional:- 


-slot  number 


-nmegs  count 


-lb  mode  mode 


-spd_mode  mode 


Specifies  the  slot  number  on  which  the  diagnostic  operates.  The  ports  specified 
are  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed  to  operate 
on  fixed-port-count  products. 

Specifies  the  number  of  frames  to  send  in  millions.  The  test  progresses  until  the 
specified  number  of  frames  transmits  on  each  port.  The  default  value  is  1 0, 
which  represents  10  million  frames. 

Select  the  loopback  point  for  the  test.  By  default,  spinJitter  uses  port 
loopback. 


0 
1 


Cable  loopback 

Port  loopback  (loopback  plugs) 

External  (SERDES)  loopback 


3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 

Specifies  the  speed  mode  for  the  test.  This  parameter  is  used  for  Bloom  and 
Condor  ASIC-based  products  only,  for  which  it  controls  the  speed  at  which 
each  port  operates.  For  lG-only  products,  this  parameter  is  ignored.  The  exact 
operation  of  modes  5  through  8  depends  on  the  loopback  mode  selected. 
When  speed  modes  5  through  8  are  used  with  cables,  they  must  be  connected 
EVEN->ODD  or  the  test  fails. 

0  Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 


1 

2 
4 


Run  test  at  1  Gb/s. 

Run  test  at  2  Gb/s.  (Bloom  default) 

Run  test  at  4  Gb/s.  (Condor  default) 
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For  -lb_mode  set  to  0,1,  the  following  speed  modes  are  available  to  test  the 
speed  negotiation. 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  2Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  2  Gb/s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun. 

3.5  Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  for  1 
Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  for  2 
Gb/s. 

-ports  Specifies  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in  the  specified 

itemlist  slot  (-slot)  will  be  used.  See  itemList  for  further  details. 

Examples 

To  measure  line-speed  jitter: 


switch : admin> 

spinjitter  -ports  1/0  - 

-  1/2 

Running  SpinJitter   

One  moment  please  . . . Ports  Segmented 

(0) 

switchName : 

SW12000A 

switchType : 

10  . 1 

switchState : 

Offline 

switchRole : 

Disabled 

switchDomain : 

1  (unconfirmed) 

switchld: 

fffcOl 

switchWwn: 

10:00:00:60:69:80:03 

0c 

switchBeacon: 

OFF 

bladel :  Beacon 

:  OFF 

blade2 :  Beacon 

:  OFF 

blade3 :  Beacon 

:  OFF 

blade4 :  Beacon 

:  OFF 

Area  Slot  Port 

Gbic  Speed  State 

0  10 

id        2G  Online 

Testing   

111 

id        2G  Online 

Testing   

2  12 

id        2G  Online 

Testing   

(output  truncated) 
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Diagnostics 

When  it  detects  failures,  the  test  might  report  one  or  more  of  the  following  error  messages: 

DATA 

EPI1_STATUS_ERR 


ERR_ 

_STAT 

ERR_ 

_STATS 

ERR_ 

_STATS_2LONG 

ERR_ 

_STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR_ 

_STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2L0NG 

ERR_ 

_STAT_BADEOF 

ERR_ 

_S  TAT_B  ADO  S 

ERR_ 

_STAT_C3DISC 

ERR_ 

_STAT_CRC 

ERR_ 

_STAT_ENC IN 

ERR_ 

_STAT_ENCOUT 

ERR_ 

_STAT_TRUNC 

FDET_PERR 
FINISH_MSG_ERR 
FTPRT_STATUS_ERR 
INIT 

LESSN_STATUS_ERR 

MBUF_STATE_ERR 

MBUF_STATUS_ERR 

NO_SEGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

PORT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 
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See  also 

backport 
camTest 

centralMemoryTest 

cmeraRetentionTest 

cmiTest 

crossPortTest 

itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRetentionTest 
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spinSilk 


Performs  a  functional  test  of  internal  and  external  transmit  and  receive  paths. 

Synopsis 

spinsilk  [ -nmegs  count]  [-lb_mode  mode]  [ -spd_mode  mode]  [-verbose  mode]  [-ports 
i  temlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  intended  functional  operation  of  the  switch,  at  the  selected  speed,  by 
configuring  the  routing  hardware  so  that  frames  received  by  port  M  are  retransmitted  by  way  of  port  N. 
Likewise,  frames  received  by  port  N  are  retransmitted  by  way  of  port  M.  Each  port  M  sends  one  frame  to 
its  partner  port  N. 

The  partner  port  N  for  each  port  M  is  determined  by  the  external  Fibre  Channel  cable  connections,  if 
present.  If  self-loopback  plugs  are  used,  the  system  assigns  a  set  of  partner  ports  to  optimize  test 
coverage.  In  this  case,  it  is  possible  for  each  port  to  have  up  to  10  partner  ports  rather  than  a  single 
partner  selected  by  the  cables. 

The  cables  can  connect  to  any  port  combination  with  the  condition  that  the  cables  and  media  connected 
are  of  the  same  technology;  for  instance,  a  short-wavelength  media  port  connects  to  another  short- 
wavelength  media  port  by  way  of  a  short-wavelength  cable,  a  long-wavelength  port  connects  to  a  long- 
wavelength  port,  and  a  copper  port  connects  to  a  copper  port. 

For  the  best  coverage,  use  self-loopback  plugs,  as  each  port  exchanges  frames  with  up  to  10  other 
predetermined  ports.  Frames  are  exchanged  with  a  selected  port  from  the  ASIC  (0-0,  0-1,  0-2,  0-3,  and 
so  forth),  mirrored  on  the  port  on  the  next  ASIC  (0-4,  0-8,  and  so  forth),  and  mirrored  on  the  port  on  the 
next  blade,  where  applicable  (0-16,  0-32,  and  so  forth).  An  error  is  reported  if  there  are  missing  plugs. 

If  you  want  to  use  cables  instead,  the  ports  connected  should  be  from  different  ASICs.  Ports  0  through  3 
belong  to  ASIC  0,  ports  4  through  7  belong  to  ASIC  1 ,  and  so  forth.  A  connection  from  port  0  to  port  1 5 
exercises  the  transmit  path  between  ASICs.  A  connection  from  port  0  to  port  3  tests  only  the  internal 
transmit  path  in  ASIC  0. 


r2^Jf  NOTE:    If  loopback  modes  0  (cable)  or  1  (loopback  plug,  default)  are  selected,  you  must  have  the 
b— I    appropriate  termination  on  all  tested  ports.  If  not,  the  ports  without  the  correct  termination  do  not  achieve 
synchronization,  and  the  test  fails. 


The  frames  are  transmitted  and  received  continuously  in  all  ports  in  parallel.  The  port  LEDs  flicker  green 
rapidly  while  the  test  is  running. 

The  test  method  is  as  follows: 

1.  Determine  which  ports  are  connected  to  each  other. 

2.  Enable  ports  for  cabled  or  self-loopback  mode. 

3.  Configure  the  routing  table  such  that  when  port  M  receives  frames,  they  are  routed  back  to  the 
partner  port  N,  and  vice  versa. 

4.  Transmit  one  frame  through  port  M.  The  frame  used  is  one  of  the  following: 

•  21 12  bytes  of  BYTEJ.FSR 

•  1 000  bytes  of  CSPAT 
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•  128  bytes  of  RANDOM 

•  512  bytes  of  RDRAM_PAT 

The  partner  port  N  eventually  sends  four  similar  frames,  as  follows: 

•  2112  bytes  of  BYTE_LFSR 

•  928  bytes  of  CSPAT 

•  200  bytes  of  RANDOM 

•  480  bytes  of  RDRAM_PAT 
5.  Periodically  check  the  following: 

a.  No  port  has  died. 

b.  Each  port's  frames-transmitted  counter  is  still  incrementing. 

c.  Each  port's  statistic  error  counters  is  nonzero— ENC_in,  CRC_err,  TruncFrm,  FrmTooLong, 
BadEOF,  Enc_out,  BadOrdSet,  DiscC3— until  one  of  the  following  is  met: 

•  The  number  of  million  frames  requested  per  port  is  met. 

•  All  ports  are  eventually  marked  bad. 

•  You  send  a  keyboard  (or  button)  interrupt  to  abort. 

The  data  is  not  read  and  checked,  as  with  the  portLoopbackTest  and  crossPortTest  commands. 
There  is  no  CPU  intervention  besides  the  periodic  checks  of  the  hardware  counters. 

An  example  of  the  data  used  is  as  follows: 

CSPAT:  0x7e,  0x7e,  0x7e,  0x7e,  ... 

BYTE_LFSR:  0x69,  0x01,  0x02,  0x05,  ... 

RANDOM:  0x25,  0x7 f,  0x6e,  0x9a,  ... 

RDRAM_PAT:  Oxff,  0x00,  Oxff,  0x00,  ... 

Because  this  test  includes  the  media  and  the  fiber  cable  in  its  test  path,  its  results,  combined  with  the 
results  of  portLoopbackTest,  can  be  used  to  determine  which  components  of  the  switch  are  faulty. 

Operands 

This  command  has  the  following  operands:- 

-nmegs  count         Specify  the  number  of  million  frames  to  send.  The  test  will  progress  until  the 
specified  number  of  frames  has  been  transmitted  on  each  port.  The  test  result 
might  display  that  more,  but  not  less,  frames  have  been  transmitted  on  some 
ports.  The  default  value  is  1 0,  so  the  number  of  frames  sent  will  be  at  least  1 0 
million. 

-lb_mode  mode  Specify  the  loopback  point  for  the  test.  By  default,  spinSilk  uses  loopback 
plugs  as  described  earlier;  however,  for  debugging  purposes,  you  can  select 
other  loopback  modes,  as  follows: 


0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

4  Internal  (parallel)  loopback 
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-spd_mode  mode     Specify  the  speed  mode  for  the  test.  This  parameter  is  used  only  for  Bloom  and 
Condor  ASIC-based  products,  where  it  controls  the  speed  at  which  each  port  is 
operated.  For  1  Gb/s-only  products,  it  is  ignored.  The  exact  operation  of 
modes  5  through  8  depends  upon  the  loopback  mode  selected.  When  speed 
modes  5  through  8  are  used  with  cables,  they  must  be  connected  EVEN  to 
ODD  or  the  test  will  fail. 

0  Run  test  at  1  Gb/sec,  2  Gb/sec,  and  4  Gb/sec. 

1  Run  test  at  1  Gb/sec. 

2  Run  test  at  2  Gb/sec  (Bloom  default). 
4  Run  test  at  4  Gb/sec  (Condor  default). 

For  -lb_mode  set  to  0  or  1 ,  the  following  speed  modes  are  available  to  test 
the  speed  negotiation: 

3  Set  all  even  ports'  speed  to  auto-negotiate;  set  all  odd  ports'  speed 
to  1  Gb/sec. 

4  Set  all  even  ports'  speed  to  auto-negotiate;  set  all  odd  ports'  speed 
to  2  Gb/ sec. 

5  Set  all  odd  ports'  speed  to  auto-negotiate;  set  all  even  ports'  speed 
to  1  Gb/sec. 

6  Set  all  odd  ports'  speed  to  auto-negotiate;  set  all  even  ports'  speed 
to  2  Gb/ sec. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun: 

3.5  Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  to  1 
Gb/s. 

4.6  Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  to  2 
Gb/s. 

--verbose  mode  Specify  a  nonzero  value  to  display  more  detailed  information  during 

the  test.  This  mode  should  be  used  for  debugging  purposes. 

-ports  Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  in  the  current 

itemlist  switch  are  tested.  This  option  might  be  used  to  restrict  testing  to  the  specified 

ports. 
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Examples 

To  perform  a  functional  test  on  selected  ports: 


switch :  admin> 

spinsilk  -ports  1/0  - 

1/2 

Running  Spin  S 

ilk   

One  moment  pie 

ase   . . . Ports 

Segmented 

(0) 

switchName : 

switch 

switchType : 

10.1 

switchState : 

Offline 

switchRole : 

Disabled 

switchDomain : 

1  (unconfi 

rmed) 

switchld: 

fffcOl 

switchWwn: 

10:00:00:6 

0:69:80:03 

:0c 

switchBeacon : 

OFF 

bladel :  Beacon 

:  OFF 

blade2 :  Beacon 

:  OFF 

blade3 :  Beacon 

:  OFF 

blade4 :  Beacon 

:  OFF 

Area  Slot  Port 

Gbic  Speed 

State 

0  10 

id  2G 

Online 

Testing   

111 

id  2G 

Online 

Testing   

2  12 

id  2G 

Online 

Testing   

(output  trunca 

ted) 

Diagnostics 

Following  are  the  possible  error  messages  if  failures  are  detected: 

DATA 

EPI1_STATUS_ERR 


ERR_ 

STAT 

ERR_ 

_STATS 

ERR_ 

_STATS_2LONG 

ERR_ 

_STATS_BADEOF 

ERR_ 

_STATS_BADOS 

ERR_ 

_STATS_C3DISC 

ERR_ 

_STATS_CRC 

ERR_ 

_STATS_ENCIN 

ERR_ 

_STATS_ENCOUT 

ERR_ 

_STATS_TRUNC 

ERR_ 

_STAT_2  LONG 

ERR_ 

_STAT_BADEOF 

ERR_ 

_STAT_BADOS 

ERR_ 

_STAT_C3DISC 

ERR_ 

_STAT_CRC 

ERR_ 

_STAT_ENC IN 

ERR_ 

_STAT_ENCOUT 
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ERR_STAT_TRUNC 

FDET_PERR 

FINISH_MSG_ERR 

FTPRT_STATUS_ERR 

INIT 

LESSN_STATUS_ERR 

MBUF_S  TATE_ERR 

MBUF_STATUS_ERRBAR> 

NO_S  EGMENT 

PORT_ABSENT 

PORT_DIED 

PORT_ENABLE 

P0RT_M2M 

PORT_STOPPED 

PORT_WRONG 

RXQ_FRAME_ERR 

RXQ_RAM_PERR 

STATS 

STATS_C3FRX 

STATS_FRX 

STATS_FTX 

TIMEOUT 

XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

backport 
camTest 

centralMeraoryTest 

cmemRetentionTest 

cmiTest 

cross PortTest 

itemList 

portLoopbackTest 
portRegTest 
spinJitter 
sraraRetentionTest 
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sramRetentionTest 


Performs  a  data  retention  test  of  the  miscellaneous  SRAMs  in  ASIC. 

Synopsis 

sramretentiontest   [--slot  slotnumber]  [-passcnt  count] [-ports 
itemlist]  [-skip  bitmask]  [-delay  value] 

Availability 

admin 

Description 

Use  this  command  to  verify  that  data  written  into  the  miscellaneous  SRAMs  in  the  ASIC  are  retained  after 
a  1 0-second  wait.  The  method  used  is  to  write  a  fill  pattern  to  all  SRAMs,  wait  1 0  seconds,  and  then  read 
all  SRAMs,  checking  that  the  data  read  matches  the  data  previously  written.  The  test  is  repeated  using  the 
inverted  version  of  the  pattern.  The  test  will  use  four  QUADFILL  patterns  and  one  QUAD  RAMP  pattern 
with  random  seed.  The  first  four  QUAD  FILL  patterns  are: 

Oxff ff ff ff 
0x55555555 
0x33333333 
OxOf Of Of Of Of 

For  details  about  the  patterns  used  in  diagnostic  tests,  see  the  dataTypeShow  command. 

'2^>  NOTE:    The  sramRetentionTest  command  cannot  be  executed  on  an  operational  switch.  You  must 
first  disable  the  switch  using  the  switchDisable  command. 


Operands 

This  command  has  the  following  operands: 

--slot  slotnumber     Specify  the  number  of  the  slot  on  which  the  diagnostic  operates.  The  ports 

specified  are  relative  to  this  slot  number.  The  default  is  set  to  0  and 
designed  to  operate  on  fixed-port-count  products. 

-passcnt  count  Specify  the  number  of  times  to  execute  this  test.  The  default  value  is  1 . 

-ports  itemlist        Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports  in  the 

specified  slot  are  used.  See  itemList  for  more  details. 

-skip  bitmask  Specify  patterns  to  omit  in  the  test.  This  command  uses  the  data  patterns 

described  in  the  section  above  by  default.  Using  this  option,  you  can 
intentionally  omit  one  or  more  patterns,  if  needed. 

-delay  value  Specify  the  delay  between  the  read  and  write,  in  seconds.  The  default  value 

is  1 0  seconds. 

Examples 

To  run  a  data  retention  test: 

switch : admin>  sramretentiontest  2 
Running  SRAM  Retention  Test  . . .  passed. 
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Diagnostics 

Following  are  the  possible  error  messages  if  failures  are  detected: 

BUS_TIMEOUT 

REGERR 

REGERR_UNRST 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

camTest 

centralMeraoryTest 

cmiTest 

crossPortTest 

dataTypeShow 

itemList 

portLoopbackTest 
spinSilk 
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statsClear 

Clears  port  and  diagnostic  statistics. 

Synopsis 

statsclear   [--slot  slotnumber]  [-uports  itemlist]  [-bports  itemlist] 
[-use_bports  value] 

Availability 

admin 

Description 

Use  this  command  to  clear  the  port  and  diagnostics  statistics  for  the  specified  list  of  blade  or  user  ports. 

Options 

The  following  are  optional: 

--slot  slotnumber     Specifies  the  slot  on  which  to  operate.  If  this  option  is  not  specified,  the 

default  slot  is  assumed.  The  default  slot  is  0  and  designed  to  operate  on 
fixed-port-count  products,  if  -use_bports  is  set  to  a  nonzero  value. 

-uports  itemlist       Specifies  the  list  of  user  ports  to  clear. 

-bports  itemlist       Specifies  the  list  of  blade  ports  to  clear. 

-use_bports  value     If  value  is  nonzero,  the  diagnostics  statistics  for  the  blade  ports  specified 

in  use-bports  are  cleared;  otherwise,  the  user  ports  specified  in 
-uports  clears.  The  default  value  is  0. 

Examples 

To  clear  port  and  diagnostic  statistics: 

switch :admin>  statsclear  -bports  1/10-1/62  -use_bports  1 

See  also 

itemList 
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statsTest 


Runs  a  statistics  counter  diagnostic  test. 


Synopsis 


statstest   [-passcnt  count] [ -ports  itemlist] 


Availability 


admin 


Description 


Use  this  command  to  verify  the  ASIC  statistics  counter  logic.  It  can  run  on  every  base  port  of  the  quadrant, 
and  send  the  frame  through  internal  loopback  with  no  CRC  data  to  induce  the  CRC  error.  This  command 
is  also  run  from  camTest. 

This  test  covers  the  following  statistics  counter  functionality: 

•  The  number  of  received  frames  with  CRC  errors  that  matched  the  SID-DID  pair  specified  in  the  LINK 
table.  There  are  1 6  of  these  statistics  counters  (0-1 5). 

•  The  number  of  received  words  in  frames  that  matched  the  SID-DID  pair  specified  in  the  LINK  table. 
There  are  1 6  of  these  statistics  counters  (0-1 5). 

The  number  of  transmitted  words  in  frames  that  matched  the  SID-DID  pair  specified  in  the  LINK  table. 
There  are  1 6  of  these  statistics  counters  (0-1 5). 

•  The  number  of  frames  with  CRC  error  that  matched  the  corresponding  ALI  (0-1  27),  respectively. 

This  command  cannot  be  executed  on  an  operational  switch.  You  must  first  disable  the  switch  using  the 

switchDisable  command. 


[^}f  NOTE:  There  is  a  link  table  that  stores  1 6  pairs  of  SID-DID  address.  Each  of  the  SID-DID  pairs  is  named 
b_ I    a  link.  This  table  is  used  for  gathering  statistics  that  match  the  link. 

This  command  is  not  supported  on  HP  StorageWorks  4/8,  4/16,  or  4/32  SAN  switches  and  4/256 

SAN  Director;  use  miniCycle  or  portLoopbackTest  instead. 


Operands 

This  command  has  the  following  optional  operands: 


-passcnt  count 


Specify  the  number  of  times  to  perform  this  test.  The  default  value 


is  1. 


ports  itemlist 


Specify  a  list  of  user  ports  to  run  the  test.  If  omitted,  all  the  user 
ports  in  the  switch  are  assumed.  See  itemList  for  more 
information  about  selecting  ports. 


Examples 


To  run  a  statistics  counter  test  on  a  switch: 


switch: admin>  statstest  -passcnt  1  -ports  1/0-15 


Running  Statistics  Counter  Test 


passed. 
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Diagnostics 

When  it  detects  failures,  the  subtest  reports  one  or  more  of  the  following  error  messages: 


DIAG-STSINIT 

DIAG-STSNULL 

DIAG-STSSID 

DIAG-STSXMIT 

DIAG-STSRCV 

DIAG-STSFRMCNT 

DIAG-STSWRDCNT 

DIAG-STSALPACNT 


See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 


See  also 

camTest 
itemList 
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stopPortTest 

Terminates  the  running  portTest. 

Synopsis 

stopporttest   [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  stop  the  currently  running  portTest.  See  the  portTest  command  for  more 
information. 

If  portTest  is  running  in  nonsingle  mode,  use  stopporttest  to  stop  the  test. 

Operands 

The  command  has  the  following  operands: 

-ports  itemlist      Specify  a  list  of  user  ports  to  test.  By  default,  all  the  user  ports  in  the  switch 
are  tested.  See  itemList  help  pages  for  further  details. 

Examples 

To  stop  the  portTest  command: 

switch: admin>  stopporttest 

See  also 

cross PortTest 

fportTest 

loopPortTest 

portLoopbackTest 

portTest 

portTestShow 

spinFab 


668   Fabric  OS  commands 


supportFtp 

Sets,  clears,  or  displays  support  FTP  parameters,  or  a  time  interval  to  check  the  FTP  server. 

Synopsis 

supportftp  [-S] 

supportftp  -s    [-h  hostip]    [-u  username]    [-p  password]    [-d  remotedirectory] 

supportftp  -t  hours 

supportftp  -R 

Availability 

admin 

Description 

Use  this  command  to  set,  clear,  or  display  support  FTP  parameters  or  a  time  interval  to  check  the  FTP 
server. 

'2^?  NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  supportFtp  -S  . 


Operands 

This  command  has  the  following  mutually  exclusive  operands: 

--S  Displays  FTP  parameters. 

--s  Sets  the  FTP  parameters,  -s  has  the  following  optional  operands: 

h  hostip  Specifies  the  FTP  host  IP  address.  It  must  be  an  IP 

address,  hostip  should  be  less  than  48 
characters. 

-u  username  Specifies  the  FTP  user  name,  username  should  be 

less  than  48  characters. 

-p  password  Specifies  the  FTP  user  password.  If  the  user  name  is 

anonymous,  the  password  is  not  needed. 
password  should  be  less  than  48  characters. 

-d  remotedirectory      Specifies  the  remote  directory  in  which  to  store 

trace  dump  files.  supportFtp  cannot  take  a  slash 
(  /  )  as  a  directory  name,  remotedirectory 
should  be  less  than  48  characters. 

--t  Sets  the  time  interval  at  which  to  check  the  FTP  server,  -t  has  the  following 

required  operands: 

hours  Checks  the  connectivity  of  the  FTP  server  at  the 

indicated  time  interval  (in  hours). 

-R  Clears  FTP  parameters. 
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Examples 

To  set  the  FTP  parameters: 


switch: admin>  supportftp  -s  -h  192.168.67.126  -u  anonymous  -d  tracedump 
supportftp:   ftp  parameters  changed. 

To  display  a  time  interval  at  which  to  check  the  FTP  server: 

switch: admin>  supportftp  -t  24 
supportftp:   ftp  check  period  changed. 

See  also 

supportSave 

supportShow 

traceDump 

traceFtp 

traceTrig 
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supportSave 

Saves  support  information  for  RASLOG,  TRACE,  and  supportShow. 

Synopsis 

supportsave   [-n]    [-c]    [-u  user_name  -p  password]    -h  host_ip  -d  remote_dir 

Availability 

admin 

Description 

Use  this  command  to  save  RASLOG,  TRACE,  and  supportShow  information  and  other  support 
information  to  a  remote  FTP  location.  On  a  dual-CP  system,  only  the  local  CP  information  is  saved  and 
supportShow  information  is  not  available  on  the  active  CP.  If  no  operands  are  specified,  this  command 
enters  interactive  mode.  The  following  output  files  are  generated: 

RASLOG  chassisname-slot-YYYYMMDDHHMM-err'DumpAll .  ss 

TRACE  chassisname-slot-YYYYMMDDHHMM-tracedump . dmp 

supportShow  ch ass isname- slot- YYYYMMDDHHMM-  supportShow 

Zone  log  chassisname-slot-YYYYMMDDHHMM-zone . ss 

RCS  command  log  chassisname-slot-YYYYMMDDHHMM-rcscmd.  ss 

NS  event  log  ch ass isname- slot- YYYYMMDDHHMM-ns . ss 

Logs  are  saved  in  the  specified  remote  directory. 

Also,  this  command  reminds  you  whether  or  not  a  new  trace  dump  needs  to  be  generated  manually 
before  you  run  supportSave. 

Operands 

The  operands  are  as  follows: 

-n  Does  not  prompt  you  for  confirmation.  This  operand  is  optional;  if  omitted, 

you  are  prompted  for  confirmation. 

-c  Uses  the  FTP  parameters  saved  by  the  command  supportFtp.  This  operand 

is  optional;  if  omitted,  specify  the  FTP  parameters  through  command  line 
options  or  interactively.  To  display  the  current  FTP  parameters,  run 

supportFtp  (on  a  dual-CP  system,  run  supportFtp  on  the  active  CP). 

jjpjf    NOTE:   The  -c  operand  is  mutually  exclusive  with  -u,  -p,  -h,  and  -d. 

-u  user_name  Specifies  the  user  name  for  the  FTP  server.  This  operand  is  optional;  if 

omitted,  anonymous  FTP  is  used. 

-p  password  Specifies  the  password  for  the  FTP  server.  This  operand  is  optional;  if  omitted, 

anonymous  FTP  is  used. 

-h  host_ip  Specifies  the  IP  address  for  the  FTP  server. 

-d  remote_dir         Specifies  the  remote  directory  for  the  FTP  server. 
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Examples 

To  save  RASLOG,  TRACE,  and  supportShow  information  to  an  FTP  server  in  non-interactive  mode: 


switch : admin>  supportsave  -n  -u  admin  -p  pass  -h  192.168.1.1  -d  tmp 


Saving  support  information  for  module  RASLOG. . . 


. . .ortSave_files/switch-S5-200405200010-errDumpAll.ss 
566.47  B/s 


1.66  kB 


Saving  support  information  for  module  TRACE... 


. . .ortSave_files/switch-S5-200405200010-tracedump.dmp 
848.00  kB/s 


10.00  MB 


Saving  support  information  for  module  SUPPORTSHOW. . . 


. . .rtSave_files/switch-S5-200405200014-supportShow.ss 
346.39  kB/s 


1.11  MB 


To  save  RASLOG,  TRACE,  and  supportShow  information  to  an  FTP  server  in  interactive  mode  on  a 
dual-CP  system: 


switch: admin>  supportsave 


This  command  will  collect  RASLOG,  TRACE,  supportShow  and  other  support 
information  and  then  transf  er  them  to  a  FTP  server.  Only  the  local  CP's 
information  will  be  saved 

and  supportShow  information  is  only  available  on  the  Active  CP.  This 
operation 

can  take  several  minutes.   OK  to  proceed?    (yes,  y,   no,   n) :    [no]  y 


Host  IP:  192.168.1.1 


User  Name:  admin 


Password: 


Remote  Directory:  tmp 


Saving  support  information  for  module  RASLOG. . . 


. . .ortSave_files/switch-S5-200405200010-errDumpAll.ss:  1.66  kB 
566.47  B/s 


Saving  support  information  for  module  TRACE... 


. . .ortSave_files/switch-S5-200405200010-tracedump.dmp:  10.00  MB 
848.00  kB/s 


Saving  support  information  for  module  SUPPORTSHOW. . . 


. . .pportSave_f iles/switch-S5-200405200014-supportShow:         1.11  MB 


346.39  kB/s 


See  also 


supportFtp 
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supportShow 
traceDump 
traceFtp 
traceTrig 
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supportShow 

Prints  switch  information  for  debugging  purposes. 

Synopsis 

supportshow   [ [slotnumber/]portnumberl-portnuniber2]  [lines] 

Availability 

all  users 

Description 

Use  this  command  to  display  support  information  from  groups  of  preselected  Fabric  OS  and  Linux 
commands.  You  can  specify  the  range  of  ports  for  which  this  information  displays.  These  commands  are 
organized  by  groups,  but  note  that  the  order  of  the  groups  listed  next  is  not  the  same  as  executed  by  the 
command. 

See  "supportShow  reference"  on  page  789,  for  more  information. 
The  commands  can  be  arranged  in  groups,  as  follows: 

•  OS  (ENABLED  by  default;  Linux®  commands  are  not  documented  in  this  manual) 

•  mii-tool 

•  du 

•  ps 

•  rpm 

•  dmesg 

•  fstab 

•  mtab 

•  various  proc  entries 

•  find  core  files 

•  exception  (ENABLED  by  default) 

•  errDump 

•  pdShow 

•  port  (ENABLED  by  default) 

•  diagShow  (per-slot) 

•  portShow  (per-slot) 

•  portLoginShow  (per-slot) 

•  portRegTest  (per-slot) 

•  portRouteShow  (per-slot) 

•  fabric  (ENABLED  by  default) 

•  fabricShow 

•  islShow 

•  trunkShow 

•  topologyShow 

•  lSDbShow 

•  ess  show 

•  f abStateResize 

•  f abSwitchShow 
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•  fabPortShow 

•  fspfShow 

•  fcpLogShow 

•  zone  stateshow 

•  portZoneShow 

•  portCamShow 

•  cfgShow 

•  cfgSize 

•  rcssmshow 

•  rcsregistryshow 

•  zone  mergeshow 

•  services  (ENABLED  by  default) 

•  f dmiCacheShow 

•  fdmiShow 

•  nsShow 

•  nsAllShow 

•  nscamShow 

•  security  (ENABLED  by  default) 

•  authutil 

•  secFabricShow 

•  secGlobalShow 

•  secModeShow 

•  secStatsShow 

•  network  (ENABLED  by  default) 

•  bootenv 

•  df 

•  ifconfig 

•  route 

•  hostname 

•  portlog  (ENABLED  by  default) 

•  portLogDump 

•  system  (ENABLED  by  default) 

•  myld 

•  version 

•  firmware Show 

•  upTime 

•  switchStatusShow 

•  switchShow 

•  haDump  (includes  haShow  and  ipAddrShow) 

•  tempShow 

•  sensorShow 

•  psShow 

•  licenseShow 

•  portFlagsShow 

•  portCfgShow 
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•  portErrShow 

•  fwSamShow 

•  agtCfgShow 

•  slotShow  (product-dependent) 

•  emtraceshow 

•  emtraceshow2 

•  emhsmtraceshow 

•  systraceshow  -d 

•  fwAlarmsFilterShow 

•  chassisShow 

•  timeout 

•  historyShow 

•  portSwapShow 

•  configShow 

•  extend  (DISABLED  by  default) 

•  buffers  (per-port) 

•  credits  (per-port) 

•  data  (per-port) 

•  phantom  (per-port) 

•  properties  (per-port) 

•  statistics  (per-port) 

•  filter  (DISABLED  by  default;  this  group  has  lengthy  output) 

•  filterportshow  (per-port) 

•  perfmon  (DISABLED  by  default) 

•  ps_dump  (per-port;  this  group  has  lengthy  output) 

•  ficon  (DISABLED  by  default;  this  group  has  lengthy  output) 

•  f iconcupshow fmsmode 

•  f  iconcupshow  modereg 

•  ficonDbg  dump  rnid 

•  ficonDbg  log 

•  ficonShow  ilir 

•  ficonShow  lirr 

•  ficonShow  rlir 

•  ficonShow  rnid 

•  ficonShow  switchrnid 

•  ficucmd  dump  -A 


Operands 


This  command  has  the  following  operands: 


slotnumber/ portnumberl 
-portnumber2 


Specify  the  range  of  ports  to  display.  If  the 
slotnumber /portnumber  parameter  is  omitted,  all  ports 
in  the  switch  display  in  the  per-port  outputs.  The 
slotnumber  must  be  provided  when  specifying  a  range  of 
ports  on  multi-bladed  products. 
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lines 


Specifies  the  number  of  lines  of  portLogDump  output  to 
display.  If  this  parameter  used,  the 
slotnumber/portnumber  parameter  is  required. 


Example 

To  display  switch  information  for  debugging: 


switch :admin>  supportshow  1/1-3 
supportshow  groups  enabled:  system 
version : 

Kernel:  2.4.19 
Fabric  OS:     v4 . 1 . 0 

Made  on:  Fri  Jan  10  01:06:10  2003 
Flash:  Thu  Jan  17  00:06:52  2003 

BootProm:  3.2.1 


uptime : 

10:49am    up     3:25,     1  user,     load  average:   1.55,    1.20,  1.11 


switchshow: 

switchName : 

Ulysses2 

switchType : 

10  . 1 

switchstate : 

Online 

switchMode : 

Native 

switchRole : 

Principal 

switchDomain : 

1 

switchld: 

fffcOl 

switchWwn : 

10:00:00: 

zoning : 

OFF 

switchBeacon: 

OFF 

bladel  Beacon: 

OFF 

blade2  Beacon: 

OFF 

blade4  Beacon: 

OFF 

Area  Slot  Port  Media  Speed  State 


0 

1 

0 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

0 

1 

1 

1 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

1 

2 

1 

2 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

2 

3 

1 

3 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

3 

4 

1 

4 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

4 

5 

1 

5 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

5 

6 

1 

6 

id 

N2 

Online 

Loopback- 

>Slot 

1 

Port 

6 

(output  truncated) 
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See  also 

supportFtp 

supportSave 

supportShowCfgDi sable 

supportShowCf gEnable 

supportShowCf gShow 

traceDump 

traceFtp 

traceTrig 
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supportShowCfgDisable 

Disables  a  group  of  commands  under  the  supportShow  command. 

Synopsis 

supportshowcf gdisable  [os  |  exception  |  port  |  fabric  |  services  |  security 
|   network   |   portlog   |    system   |    extend   |    filter    |   perfmon    |  ficon] 

Availability 

admin 

Description 

Use  this  command  to  disable  a  group  of  commands  under  the  supportShow  command.  Use  the 
supportShowCf  gEnable  command  to  enable  groups  of  commands.  See  "supportShow  reference"  on 
page  789,  for  more  information. 

Operands 

This  command  has  the  following  operands: 


OS 

Disables 

the  OS  group  commands 

exception 

Disables 

the  exception  group  commands 

port 

Disables 

the  port  group  commands 

fabric 

Disables 

the  fabric  group  commands 

services 

Disables 

the  service  group  commands 

security 

Disables 

the  security  group  commands 

network 

Disables 

the  network  group  commands 

portlog 

Disables 

the  portlog  group  commands 

system 

Disables 

the  system  group  commands 

extend 

Disables 

the  extend  group  commands 

filter 

Disables 

the  filter  group  commands 

perfmon 

Disables 

the  Performance  Monitor  group  commands 

ficon 

Disables 

the  FICON  group  commands 

Examples 

To  disable  the  OS  group  of  commands  under  the  supportShow  command: 

switch :admin>  supportshowcf gdisable  os 
Config  update  Succeeded 

See  also 

supportShow 
supportShowCf gEnable 
supportShowCf gShow 
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supportShowCfgEnable 

Enables  a  group  of  commands  under  the  supportShow  command. 

Synopsis 

supportshowcf genable  [os  |  exception  |  port  |  fabric  |  services  |  security  | 
network   |   portlog   |    system   |    extend   |    filter    |   perfmon    |  ficon] 

Availability 

admin 

Description 

Use  this  command  to  enable  a  group  of  commands  under  the  supportShow  command.  Use  the 

supportShowCf  gDisable  command  to  disable  groups  of  commands. 

See  "supportShow  reference"  on  page  789,  for  more  information. 

Operands 

This  command  has  the  following  operands: 


OS 

Enables 

the  OS  group  commands 

exception 

Enables 

the  exception  group  commands 

port 

Enables 

the  port  group  commands 

fabric 

Enables 

the  fabric  group  commands 

services 

Enables 

the  service  group  commands 

security 

Enables 

the  security  group  commands 

network 

Enables 

the  network  group  commands 

portlog 

Enables 

the  portlog  group  commands 

system 

Enables 

the  system  group  commands 

extend 

Enables 

the  extend  group  commands 

filter 

Enables 

the  filter  group  commands 

perfmon 

Enables 

the  Performance  Monitor  group  commands 

ficon 

Enables 

the  FICON  group  commands 

Examples 

To  enable  a  group  of  commands  under  the  supportShow  command: 

switch: admin>  supportshowcf genable  os 
Config  update  Succeeded 

See  also 

supportShow 
supportShowCf gDisable 
supportShowCf gShow 
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supportShowCfgShow 

Displays  the  groups  of  commands  enabled  for  display  by  the  supportShow  command. 

Synopsis 

supportshowcf gshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  groups  of  commands  enabled  for  display  by  the  supportShow 
command.  Use  the  supportShowCf  gEnable  and  the  supportShowCf  gDisable  commands  to 
modify  which  groups  are  displayed. 

See  "supportShow  reference"  on  page  789,  for  more  information. 

Operands 

none 

Examples 

To  display  which  groups  of  commands  are  enabled  in  the  supportShow  command: 

switch :admin>  supportshowcf gshow 


OS 

enabled 

exception 

enabled 

port 

enabled 

fabric 

enabled 

services 

enabled 

security 

enabled 

network 

enabled 

portlog 

enabled 

system 

enabled 

extend 

disabled 

filter 

disabled 

perfmon 

disabled 

f  icon 

disabled 

See  also 

supportShow 
supportShowCf gDisable 
supportShowCf gEnable 
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switchBeacon 


Sets  switch  beaconing  mode  on  or  off. 

Synopsis 

switchbeacon  [mode] 

Availability 

admin 

Description 

Use  this  command  to  enable  or  disable  switch  beaconing  mode. 

When  beaconing  mode  is  turned  on,  the  port  LEDs  flash  amber,  left  to  right  and  right  to  left,  which 
continues  until  turned  off  by  the  user.  The  pattern  continues  until  the  user  turns  it  off.  This  can  be  used  to 
beckon  the  user  to  a  failing  unit,  for  example. 

Beaconing  mode  affects  only  the  port  LEDs.  Other  commands  are  still  executable  and  functional.  The 
normal  flashing  LED  pattern  (associated  with  an  active,  faulty,  or  disabled  port)  is  suppressed  and  the 
beaconing  pattern  is  shown.  However,  if  diagnostic  frame-based  tests  (portLoopbackTest, 
crossPortTest,  and  spinSilk)  are  executed,  two  patterns  are  interleaved.  The  diagnostic  test 
flickers  the  LEDs  green  and  simultaneously  the  beaconing  mode  runs  the  LEDs  amber. 

Use  the  switchShow  command  to  display  the  status  of  beaconing. 

Operands 

This  command  has  the  following  operand: 

mode  Specify  1  to  enable  beacon  mode  or  0  to  disable  beacon  mode. 

This  operand  is  optional.  If  no  operand  is  specified,  the  current 
value  is  displayed. 

Examples 

To  turn  beaconing  mode  on: 

switch : admin>  switchbeacon  1 

To  turn  beaconing  mode  off: 

switch : admin>  switchbeacon  0 

See  also 

switchShow 
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switchCfgPersistentDisable 


Disables  a  switch  persistently. 


Synopsis 

switchcf gpersistentdisable 

Availability 

admin 

Description 


Use  this  command  to  persistently  disable  the  switch.  All  Fibre  Channel  ports  are  taken  offline.  If  the  switch 
was  part  of  a  fabric,  the  remaining  switches  reconfigure.  The  switch  remains  disabled  even  after  a 


The  disable  process  can  be  observed  and  verified  by  watching  the  front  panel  LEDs  change  to  slow 
flashing  yellow  as  each  port  is  disabled. 

A  persistently  disabled  switch  can  be  temporarily  enabled  using  the  switchEnable  command.  A 
temporarily  enabled  switch  remains  disabled  after  a  reboot. 


NOTE:    Performance  Monitoring  cannot  be  added  to  any  port  on  a  persistently  disabled  switch. 


reboot. 


Operands 


none 


Examples 


To  disable  a  switch  persistently: 


switch: admin>  switchcf gpersistentdisable 


See  also 


switchDi sable 


switchEnable 


switchcf gPers is tentEnable 


switchShow 
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switchCfgPersistentEnable 

Enables  a  switch  persistently. 

Synopsis 

switchcf gpers is tent enable 


Availability 

admin 

Description 

Use  this  command  to  persistently  enable  the  switch.  All  Fibre  Channel  ports  which  did  not  fail  power-on 
self-test  (POST)  are  enabled,  and  can  come  online  if  connected  to  a  device,  or  remain  offline  if 
disconnected.  The  switch  might  need  to  be  enabled  if  it  was  previously  disabled  to  make  configuration 
changes  or  to  run  diagnostics. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  After  this  command  is  issued,  the  1 0  second 
fabric  stability  count  down  is  displayed.  If  this  switch  remains  the  principal  switch  at  the  end  of  the  count 
down,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then  this  switch 
becomes  a  subordinate  switch,  and  accepts  a  domain  ID  from  the  principal.  See  FC-SW  for  a  complete 
description  of  this  process. 

The  enable  process  can  be  observed  and  verified  by  watching  the  front  panel  LEDs  change  from  slow 
flashing  yellow  as  each  port  is  enabled.  The  LEDs  change  to  green  for  online  ports,  or  can  remain  black 
for  disconnected  ports,  or  yellow  for  ports  that  do  not  initialize. 

Operands 

none 

Examples 

To  configure  the  switch  as  persistently  enabled: 

switch : admin>  switchCfgPersistentEnable 
10  987654321 
fabric:   Principal  switch 
fabric:  Domain  1 


See  also 

switchDi sable 
switchEnable 

switchcf gPers is tentDi sable 
switchShow 
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switchCfgSpeed 


Configures  all  ports  of  a  switch  to  a  particular  speed. 

Synopsis 

switchcf gspeed  speed_level 

Availability 

admin 

Description 

Use  this  command  to  configure  the  speed  of  all  the  ports  on  a  switch  to  a  particular  level.  The 
configuration  is  saved  in  flash  memory  and  persists  across  switch  reboots  or  power  cycles.  If  any  port  on 
the  switch  is  not  capable  of  the  specified  speed  setting,  an  error  message  appears  for  that  port. 

The  output  of  portShow  displays  the  achieved  speed  level  and  portCf  gShow  displays  the  user's 
desired  speed  setting. 

Operands 

This  command  has  the  following  required  operand: 

speed_level  Specify  the  speed  of  a  port.  Valid  values  are  one  of  the  following: 

0  Auto-sensing  mode.  The  port  automatically  configures  for  the 
highest  speed. 

1  1-Gb/s  mode.  The  port  is  fixed  at  1  Gb/s. 

2  2-Gb/ s  mode.  The  port  is  fixed  at  2  Gb/ s. 
4          4-Gb/ s  mode.  The  port  is  fixed  at  4  Gb/ s. 

Examples 

To  set  the  speed  level  for  all  ports  on  a  switch: 

switch : admin>  switchcf gspeed  0 
Committing  configuration ...  done . 

See  also 

portCf gSpeed 
portShow 
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switchCfgTrunk 

Enables  or  disables  trunking  on  all  the  ports  of  a  switch. 

Synopsis 


switchcf gtrunk  mode 


Availability 

admin 


'^}f  NOTE:    This  command  requires  an  HP  ISL  Trunking  license. 


Description 

Use  this  command  to  enable  or  disable  trunking  on  all  the  ports  of  a  switch. 


'2^f  NOTE:    You  can  disable  or  enable  trunking  using  the  portCf  gTrunkPort  or  switchCfgTrunk 

commands.  When  the  command  is  executed  to  update  the  trunking  configuration,  the  ports  for  which  the 
configuration  applies  are  disabled  and  reenabled  with  the  new  trunk  configuration.  As  a  result,  the  traffic 
through  these  ports  might  be  disrupted  for  a  short  period  of  time. 


Operands 

This  command  has  the  following  operand: 

mode  Specify  1  to  enable  trunking  on  all  the  ports  on  this  switch.  Specify  0 

to  disable  trunking  on  all  the  ports  on  this  switch.  This  operand  is 
required. 


Examples 

To  disable  trunking  on  a  switch: 


switch : admin>  switchcf gtrunk  0 
Committing  configuration ...  done . 


See  also 

portCf gShow 
portCf gTrunkPort 
portShow 
switchShow 
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switchDisable 

Disables  the  switch. 

Synopsis 

switchdi sable 

Availability 

admin 

Description 

Use  this  command  to  disable  the  switch.  All  Fibre  Channel  ports  are  taken  offline;  if  the  switch  was  part  of 
a  fabric,  the  remaining  switches  reconfigure. 

The  switch  must  be  disabled  before  making  configuration  changes  (using  configure  or 

conf  igDef ault)  or  before  running  many  of  the  diagnostic  tests.  All  commands  that  require  the  switch 

to  be  disabled  send  an  error  if  invoked  while  the  switch  is  enabled. 

The  switch  does  not  need  to  be  disabled  before  rebooting  or  powering  off. 

As  each  port  is  disabled,  the  front  panel  LED  changes  to  a  slow  flashing  yellow. 

Operands 

none 

Examples 

To  disable  the  switch: 

switch : admin>  switchdisable 

See  also 

switchCf gPers is tentDisable 
switchCf gPersistentEnable 
switchEnable 
switchShow 
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switchEnable 

Enables  the  switch. 

Synopsis 

switchenable 

Availability 

admin 

Description 

Use  this  command  to  enable  the  switch.  All  Fibre  Channel  ports  that  passed  POST  are  enabled.  They  can 
come  online  if  connected  to  a  device,  or  will  remain  offline  if  disconnected.  Use  switchEnable  if  you 
disable  the  switch  to  make  configuration  changes  or  to  run  diagnostics. 

If  the  switch  is  connected  to  a  fabric,  it  rejoins  the  fabric.  When  this  command  is  issued,  the  1 0-second 
fabric  stability  countdown  is  displayed.  If  this  switch  remains  the  principal  switch  at  the  end  of  the 
countdown,  then  it  assigns  itself  a  domain  ID.  If  another  switch  assumes  the  principal  role,  then  this  switch 
becomes  a  subordinate  switch  and  accepts  a  domain  ID  from  the  principal.  See  FC-SW  for  a  complete 
description  of  this  process. 

As  each  port  is  enabled,  the  front  panel  LED  changes  to  green  for  online  ports,  black  for  disconnected 
ports,  or  yellow  for  uninitialized  ports. 

Operands 

none 

Examples 

To  enable  a  switch: 

switch : admin>  switchenable 
10  987654321 
fabric:   Principal  switch 
fabric :   Domain  1 

See  also 

switchCf gPersistentDisable 
switchCf gPersistentEnable 
switchDi sable 
switchShow 
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switch  Name 


Displays  or  sets  the  switch  name. 

Synopsis 

switchname  [name] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  display  or  set  the  switch  name.  All  switches  have  a  symbolic  name  that  is  primarily 
used  for  switch  management.  This  name  is  also  shown  in  the  Fabric  OS  CLI  prompt,  under  each  switch 
icon  on  the  Fabric  Web  page,  and  in  the  output  of  various  Fabric  OS  commands,  such  as  f  abricShow. 

Use  this  command  with  the  name  operand  to  assign  a  new  switch  name.  Enter  this  command  with  no 
operand  to  display  the  current  switch  name. 

Changing  the  switch  name  causes  a  domain  address  format  RSCN  to  be  issued  (see  FC-FLA  for  a 
description  of  RSCNs). 

The  switch  name  also  can  be  changed  using  HP  Advanced  Web  Tools. 
Operands 

This  command  has  the  following  optional  operand: 
name  Specify  a  new  name  for  the  switch.  The  operand  name: 

•  Can  include  up  to  1 5  characters 

•  Must  begin  with  a  letter 

•  Must  consist  of  letters,  digits,  and  underscore  characters,  and 
no  spaces. 

If  this  operand  is  omitted,  this  command  displays  the  current 
switch  name. 

Examples 

To  change  a  switch  name  to  antina  (note  the  change  in  the  prompt  text): 


switch 

admin> 

switchname  antina 

antina 

admin> 

switchname 

antina 

See  also 

chassisShow 
switchShow 
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switch  Re  boot 


Halts  and  reboots  the  operational  switch. 


Synopsis 


switchreboot 


Availability 


admin 


Description 


This  command  reboots  the  operational  switch  without  disrupting  the  other  switch  in  a  dual-switch  chassis. 
This  command  is  equal  to  running  switchShutdown  and  switchStart. 

[2^?  NOTE:    This  command  is  not  supported  on  single-domain  systems. 


To  reboot  an  operational  switch: 

switch : admin>  switchreboot 

Stopping  all  switch  daemons  ...  Done . 

Powering  off  slot  l...Done. 

Powering  off  slot  4... Done. 

Checking  all  slots  are  powered  off... Done. 

Cleaning  up  kernel  modules  ...  Done . 

Initializing  kernel  modules  ...  Done . 

Starting  all  switch  daemons  ...  Done . 

Powering  on  slot  1. . .Done. 

Powering  on  slot  4. . .Done. 

Checking  diagnostics  ...  Done . 

setup  FCIP  IP:   ifconfig  fcO  ip=0 . 0.0.0,   netmask=2 55 . 2 55 . 2 55 . 0 


Operands 


none 


Examples 


See  also 


switchShutdown 


switchStart 
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switchShow 


Displays  switch  and  port  status. 


Synopsis 


switchshow  [-portcount] 


Availability 

all  users 

Description 

Use  this  command  to  display  switch  and  port  status  information.  Information  might  vary  by  switch  model. 
Switch  summary  information;  it  is  followed  by  a  section  covering  summary  information  by  port: 


switchName 

Displays  the  switch  symbolic  name. 

switchType 

Displays  the  switch  model  number. 

switchState 

Displays  the  switch  state:  online,  offline,  testing,  or  faulty. 

switchMode 

Displays  the  switch  mode:  native  or  interop. 

switchRole 

Displays  the  switch  role:  principal,  subordinate,  or  disabled 

switchDomain 

Displays  the  switch  domain  ID:  0  to  31  or  1  to  239. 

switchld 

Displays  the  switch  embedded  port  D  ID. 

switchWwn 

Displays  the  switch  world  wide  name  (WWN). 

switchBeacon 

Displays  the  switch  beaconing  state  (on  or  off). 

bladeBeacon 

Displays  the  blade  beaconing  state  (on  or  off). 

The  switch  summary  is  followed  by  one  line  per  port: 
Area 


Slot 
Port 

Media  Type 


Part  of  the  24-bit  port  ID,  which  consists  of  domain,  area  number,  and 
optional  AL_PA. 

Slot  number;  slots  numbered  from  1  to  4  and  7  to  10. 
Port  number;  ports  are  numbered  from  0  to  1 5  or  0  to  31 . 
Media  type: 


Speed 


dash  (■■) 

sw 

lw 

cu 

id 

Speed  of  the  port: 

1/8G 

1/4G 

1/2G 

1G 

2G 

Nl 

N2 

4G 

AN 

UN 


no  module  present 
shortwave  laser 
longwave  laser 
copper 
serial  I 


25  Mbit/sec 
250  Mbit/sec 
500  Mbit/sec 
lGb/s  fixed  transfer  speed 
2  Gb/s  fixed  transfer  speed 

1  Gb/s  negotiated  transfer  speed 

2  Gb/s  negotiated  transfer  speed 
4  Gb/s  negotiated  transfer  speed 
Auto  negotiating 

Unknown 
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Port  State  Port  state  information 

No_Card  No  interface  card  present. 

No_Module  No  module  (SFP  or  other)  present. 

Mod_Val  Module  validation  in  process. Modjnv  -  nvalid  module. 

No_Light  Module  not  receiving  light. 

No_Sync  Module  receiving  light  but  out  of  sync. 

ln_Sync  Module  receiving  light  and  in  sync. 

Laser_Flt  Module  signaling  a  laser  fault. 

Port_Flt  Port  marked  faulty. 

Diag_Flt  Port  failed  diagnostics. 

LockRef  Locking  to  the  reference  signal. 

Testing  Running  diagnostics. 

Online  Port  is  up  and  running, 
comment                        The  comment  field  is  blank,  or  displays: 

Disabled  Port  is  disabled. 

Bypassed  Port  is  bypassed  (loop  only). 

Loopback  Port  is  in  loopback  mode. 

EPort  Fabric  port;  displays  WWN  and  name  of  attached 
switch. 

FPort  Point-to-point  port;  displays  WWN  of  attached  NPort. 

G_Port  Point-to-point  but  not  yet  E  Port  or  F  Port. 

L  Port  Loop  port;  displays  number  of  NLPorts. 

(Trunk  master)        Port  is  the  master  port  in  a  group  of  trunking  ports. 

(Trunk  port,  master  is  port  #x)  -  Port  is  configured  as  a 
trunking  port;  the  master  port  is  port  number  x. 

(upstream)  _  _  . 

tPort  is  an  upstream  path  towards  the  principal  switch 

of  the  fabric. 

(downstream)        _  _     .       .  .  ,       .       .    .  . 

b_rort  is  a  downstream  path  away  trom  the  principal 

switch  of  the  fabric. 
Persistently  Disabled 

This  port  has  been  disabled  using 

portCf gPersistentDisable. 

FICON  -  Persistent  DID 

This  port  has  been  disabled  since  the  switch  could  not 
obtain  its  configuration  domain  ID  during  the  fabric 
reconfiguration  when  FICON  mode  was  enabled.  See 

f  iconShow  for  more  information. 

If  a  port  is  configured  as  a  long  distance  port,  the  long 
distance  level  is  displayed  in  the  format  of  be,  which 
represents  the  long  distance  level  number.  See 

portCf  gLongDistance  for  more  information 
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Operand 


Example 


The  operand  is  as  follows: 
-portcount  Displays  the  number  of  ports  on  the  switch. 

To  display  the  port  count: 

switch : admin>  switchShow  -portcount 
ports=  64 


To  display  the  port  status  for  an  E  Port: 


switch :user> 

switchshow 

switchName 

sanll6 

switchType 

10. 

1 

switchState : 

Online 

switchMode 

Native 

switchRole 

Subordinate 

switchDomain : 

2 

switchld: 

f f fc02 

switchWwn : 

10: 

00:00: 

60:69 

00:02 :48 

switchBeacon : 

OFF 

bladel : 

Beacon: 

OFF 

blade4 : 

Beacon: 

OFF 

Area 

Slot 

Port 

Vledia 

Speed 

State 

0 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

1C 

0 

sanl30 

id 

N2 

Online 

E- 

Port 

1 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

1C 

1 

sanl30 

id 

N2 

Online 

E- 

Port 

2 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

1C 

2 

sanl30 

id 

N2 

Online 

E- 

Port 

3 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

1C 

3 

sanl30 

id 

N2 

Online 

E- 

Port 

4 

10 : 00 : 00:60 : 

69  : 

1 
0  0  : 

02 

1C 

4 

sanl30 

id 

N2 

Online 

E- 

Port 

5 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

1C 

5 

sanl30 

id 

N2 

Online 

E- 

Port 

6 

10 : 00 : 00 : 60 : 

69  : 

1 
00  : 

02 

1C 

6 

sanl30 

id 

N2 

Online 

E- 

Port 

7 

10 : 00 : 00:60 : 

69  : 

1 
00  : 

02 

1C 

7 

sanl30 

id 

N2 

Online 

E- 

Port 

(output  truncat 

ed) 

See  also 


f iconShow 

portCf gLongDi stance 
switchDi sable 
switchEnable 
switchName 
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switchShutdown 

Halts  the  operational  switch. 

Synopsis 

switchshutdown 

Availability 

admin 

Description 

Use  this  command  to  halt  switch  operation  on  one  switch  without  disrupting  the  other.  This  command 
disables  a  logical  switch  in  a  dual-switch  chassis. 

This  command  has  to  be  used  in  combination  with  switchStart. 

This  command  halts  all  the  daemons  associated  with  the  switch,  frees  the  resources  and  object  states 
associated  with  the  switch  to  a  clear  state,  and  disables  all  the  ports  and  blades  associated  with  the 
switch. 


NOTE:    This  command  is  not  supported  on  single-domain  systems. 


Operands 

none 

Examples 

To  halt  the  operational  switch: 


switch : admin>  switchshutdown 

Stopping  all  switch  daemons  ...  Done . 

Powering  off  slot  l...Done. 

Powering  off  slot  4... Done. 

Checking  all  slots  are  powered  off. 

. Done . 

Cleaning  up  kernel  modules  ...  Done . 

See  also 

switchReboot 
switchStart 
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switchStart 


Initializes  a  previously  shut  down  switch. 


Synopsis 

switchstart 

Availability 

admin 

Description 

Use  this  command  to  initialize  one  switch  without  disrupting  the  other  switch  in  the  dual-switch  chassis. 
This  command  has  to  be  used  in  combination  with  switchShutdown. 

This  command  starts  all  the  daemons  associated  with  the  switch,  initializes  the  object  states  associated 
with  the  switch  to  a  clear  state,  and  enables  all  the  ports  and  blades  associated  with  the  switch. 

r2^f  NOTE:   This  command  is  not  supported  on  single-domain  systems. 


To  initialize  the  current  switch: 

switch : admin>  switchstart 
Initializing  kernel  modules  ...  Done . 
Starting  all  switch  daemons  ...  Done . 
Powering  on  slot  l...Done. 
Powering  on  slot  4... Done. 
Checking  diagnostics  ...  Done . 

setup  FCIP  IP:   ifconfig  fcO  ip=0. 0.0.0,   netmask=255 . 255 . 255 . 0 


Operands 


none 


Examples 


See  also 


switchReboot 


switchShutdown 
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switchStatusPolicySet 

Sets  the  policy  parameters  that  determine  overall  switch  status. 

Synopsis 

switchstatuspolicyset 

Availability 

admin 

Description 

Use  this  command  to  set  policy  parameters  for  calculating  the  overall  status  of  the  switch  enclosure.  The 
policy  parameter  values  determine  how  many  failed  or  faulty  units  of  each  contributor  are  allowed  before 
triggering  a  status  change  in  the  switch  from  HEALTHY  to  MARGINAL  or  DOWN.  The  status  of  the  switch 
can  be  found  by  issuing  the  switchStatusShow  command.  The  existence  of  policies,  such  as  Fans, 
PowerSupplies,  WWN,  CP,  and  Blade,  might  differ  from  platform  to  platform. 

The  command  displays  the  current  parameters  in  a  three-column  table  format,  shown  in  Table  1  8.  The 
command  then  prompts  the  user  to  change  the  values  for  each  policy  parameter.  The  default  values  for 
the  policy  parameters  are  in  shown  Table  18. 

Table  18    Default  contributor,  values,  and  status 


Contributor 

DOWN  default 

MARGINAL  default 

PowerSupplies 

2 

Temperatures 

2 

Fans 

2 

WWN 

0 

CP 

0 

Blade 

0 

Flash 

0 

Marginal  Ports 

2 

Faulty  Ports 

2 

MissingSFPs 

0 

0 

Any  single  contributor  can  force  the  overall  status  of  the  switch  to  MARGINAL  or  DOWN.  For  example, 
assuming  that  the  switch  contributor  values  are  set  to  the  default  values,  if  there  is  one  faulty  port  in  a 
switch,  then  this  contributor  would  set  the  overall  switch  status  to  MARGINAL.  If  two  ports  were  faulty, 
then  this  contributor  would  set  the  overall  switch  status  to  DOWN. 

Operands 

none 
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Examples 

To  change  the  switch  policies: 


switch: admin>  switchstatuspolicyset 

To  change  the  overall  switch  status  policy  parameters 
The  current  overall  switch  status  policy  parameters: 

Down  Marginal 


Power Supplies 

2 

1 

Temperatures 

2 

1 

Fans 

2 

1 

WWN 

0 

1 

CP 

0 

1 

Blade 

0 

1 

Flash 

0 

1 

Marginal Ports 

2 

1 

FaultyPorts 

2 

1 

MissingSFPs 

0 

0 

Note  that  the  value,   0,   for  a  parameter,  means  that  it  is 
NOT  used  in  the  calculation. 

**  In  addition,   if  the  range  of  settable  values  in  the 
**  prompt  is   (0..0),   the  policy  parameter  is  NOT  applicable 
**  to  the  switch.   Simply  hit  the  Return  key. 
Out  of  range  Flash  contributing  to 

MARGINAL   Status:     (0..1)  [1] 

MarginalPorts  contributing  to 

DOWN  status:    (0..64)  [2] 

MarginalPorts  contributing  to 

MARGINAL  status:    (0..64)  [1] 

(output  truncated) 

See  also 

switchStatusPolicyShow 
switchStatusShow 
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switchStatusPolicyShow 

Displays  the  policy  parameters  that  determine  overall  switch  status. 

Synopsis 

switchstatuspolicyshow 

Availability 

all  users 

Description 

Use  this  command  to  view  the  current  policy  parameters  set  for  the  switch.  These  policy  parameters 
determine  the  number  of  failed  or  nonoperational  units  allowed  for  each  contributor  before  triggering  a 
status  change  in  the  switch. 

The  command  displays  the  current  parameters  in  a  three-column  format,  shown  in  Table  1  9.  The  first 
column  indicates  the  contributor,  the  second  column  indicates  the  minimum  number  that  contributes  to  the 
DOWN  status,  and  the  third  column  indicates  the  minimum  number  that  contributes  to  the  MARGINAL 
status.  The  parameters  can  be  set  by  the  switchStatusPolicySet  command.  The  existence  of 
policies,  such  as  Fans,  PowerSupplies,  CP,  WWN,  and  Blade,  might  differ  from  platform  to  platform.  For 
example,  if  the  FaultyPorts  DOWN  parameter  is  set  to  3,  and  three  ports  fail  in  the  switch,  then  the  status 
of  the  switch  changes  to  DOWN. 

Table  19    Default  contributor,  values,  and  status 


Contributor 

DOWN  default 

MARGINAL  default 

PowerSupplies 

2 

Temperatures 

2 

Fans 

2 

WWN 

0 

CP 

0 

Blade 

0 

Flash 

0 

Marginal  Ports 

2 

FaultyPorts 

2 

MissingSFPs 

0 

0 

Operands 

none 
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Examples 

To  display  the  switch  policies: 

switch: admin>  switchstatuspolicyshow 

The  current  overall  switch  status  policy  parameters: 

Down  Marginal 


Powe  r  Supp lies 

2 

1 

Temperatures 

2 

1 

Fans 

2 

1 

WWN 

0 

1 

CP 

0 

1 

Blade 

0 

1 

Flash 

0 

1 

Marginal Ports 

2 

1 

FaultyPorts 

2 

1 

MissingSFPs 

0 

0 

See  also 

switchStatusPolicySet 
switchStatusShow 
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switchStatusShow 

Displays  overall  switch  status. 

Synopsis 

switchstatusshow 


Availability 

all  users 

Description 

Use  this  command  to  display  the  overall  status  of  the  switch.  In  addition,  users  with  a  Fabric  Watch 
license  are  able  to  view  the  list  of  unhealthy  ports. 

This  command  displays  the  overall  switch  status,  along  with  the  status  of  each  of  the  following 
contributors: 

•  Power  supplies 

•  Temperatures 

•  Fans 

•  WWN  servers  (dual-CP  systems  only) 

•  Standby  CP  (dual-CP  systems  only  with  HA  enabled) 

•  Blades  (bladed  systems  only) 

•  Flash 

•  Marginal  ports 

•  Faulty  ports 

•  Missing  SFPs 

Status  values  are  HEALTHY,  MARGINAL,  or  DOWN,  depending  on  whether  thresholds  established  by 
switchStatusPolicySet  have  been  exceeded.  The  overall  status  is  based  on  the  most  severe  status 
of  all  contributors. 

See  switchStatusPolicyShow  for  details  on  the  calculation  of  contributors  and  overall  switch  status. 

Operands 

none 
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Examples 

To  display  a  switch  health  report: 


switch :user>  switchstatusshow 

Switch  Health  Report 
10:48:31  AM 

Report  time:  06/19/2003 

Switch  Name:  switch 

IP  address:  10.10.: 

255.255 

SwitchState:  MARGINAL 

Diirntinn-  00-Ofi 

UUld  LU11  ■  VVJ.VJVJ 

T3r"lTA7£}">"       d  1  T — 17 — \  ~1    T    CO       TY1  l~ ill  1    t~  f~ 1  T" 

rUWfcJI         Ll^J^J -L  J- fcr  O    ILLUI1J-  UUI 

riLnL  1111 

Temperatures  monitor 

HEALTHY 

Fans  monitor 

MARGINAL 

WWN  servers  monitor 

HEALTHY 

Standby  CP  monitor 

HEALTHY 

Blades  monitor 

HEALTHY 

Flash  monitor 

HEALTHY 

Marginal  ports  monitor 

HEALTHY 

Faulty  ports  monitor 

HEALTHY 

Missing  SFPs  monitor 

HEALTHY 

All  ports  are  healthy 

See  also 

switchStatusPolicySet 
switchStatusPolicyShow 
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switch  Uptime 

Displays  the  amount  of  time  the  switch  has  been  operating. 

Synopsis 

switchuptime 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  time  and  the  amount  of  time  that  the  switch  has  been 
operational. 

Operands 

none 

Examples 

To  view  the  uptime  for  the  switch: 

switch :user>  switchuptime 
9:50pm      up  for  2  0  mins 

See  also 

switchReboot 

switchShutdown 

switchStart 
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syslogdFacility 

Changes  the  syslog  facility. 

Synopsis 

syslogdFacility   [-1  level] 

Availability 

admin 

Description 

Use  this  command  to  change  the  syslog  facility  to  LOG_LOCAL0,  LOGJOCALI,  LOGJ.OCAL2, 
LOG_LOCAL3,  LOG_LOCAL4,  LOG_LOCAL5,  LOG_LOCAL6,  or  LOG_LOCAL7. 

The  syslog  daemon  (syslogd)  is  a  process  available  on  most  UNIX  systems  that  reads  and  forwards 
system  messages  to  the  appropriate  log  files  or  users,  depending  on  the  system  configuration. 

The  specified  facility  is  used  when  forwarding  messages  to  the  servers  added  through  the  command 
syslogdlpAdd.  The  default  facility  is  LOG_LOCAL7. 

Operands 

This  command  has  following  operand: 

-1  level       Specifies  the  syslog  facility.  The  range  is  from  0  through  7.  This  operand  is 
optional;  if  omitted,  the  current  facility  is  displayed. 

Examples 

To  set  the  syslog  facility  to  LOG_LOCALl : 

switch : admin>  syslogdFacility  -1  1 
Syslog  facility  changed  to  L0G_L0CAL1 

See  also 

syslogdlpAdd 

sys 1 ogdlpRemove 
syslogdlpShow 
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syslogdlpAdd 

Adds  the  IP  address  of  a  syslog  daemon. 

Synopsis 

syslogdipadd  ip_address 

Availability 

admin 

Description 

Use  this  command  to  add  the  IP  address  of  the  server  that  is  running  the  syslogd  process.  The  syslog 
daemon  (syslogd)  is  a  process  available  on  most  UNIX  systems  that  reads  and  forwards  system  messages 
to  the  appropriate  log  files  or  users,  depending  on  the  system  configuration. 

When  one  or  more  IP  addresses  are  configured,  the  switch  forwards  all  error  log  entries  to  the  syslogd  on 
the  specified  servers.  Up  to  six  servers  are  supported. 

Operands 

This  command  has  the  following  required  operand: 
ip_address  Specify  the  IP  address  of  the  server  running  syslogd. 

Examples 

To  add  the  address  1 92. 1 68. 1 .60  to  the  list  of  machines  to  which  system  messages  are  sent: 

switch: admin>  syslogdipadd  192.168.1.60 

See  also 

errModuleShow 
sys 1 ogdlpRemove 
syslogdlpShow 
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syslogdlpRemove 


Removes  the  IP  address  of  a  syslog  daemon. 

Synopsis 

syslogdipremove  ip_address 

Availability 

admin 

Description 

Use  this  command  to  remove  the  IP  address  of  the  server  that  is  running  the  syslogd  process. 

Operands 

This  command  has  the  following  operand: 

ip_address  Specify  the  IP  address  of  the  server  running  syslogd.  This  operand  is  required. 

Examples 

To  remove  the  address  192.168.1 .60  from  the  list  of  machines  to  which  system  messages  are  sent: 

switch : admin>  syslogdipremove  192.168.1.60 

See  also 

errModuleShow 

syslogdlpAdd 

syslogdlpShow 
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syslogdlpShow 

Displays  all  syslog  daemon  IP  addresses. 

Synopsis 

syslogdipshow 

Availability 

all  users 

Description 

Use  this  command  to  display  all  syslog  daemon  IP  addresses  in  the  configuration  database. 

Operands 

none 

Examples 

To  display  all  syslog  daemon  IP  addresses: 


switch 

admin>  syslogdipshow 

syslog 

IP . address . 1 : 

192 

168 

.  1 

60 

syslog 

IP . address . 2 : 

192 

168 

.  1 

88 

syslog 

IP . address . 3 : 

192 

168 

.2 

77 

See  also 

errModuleShow 
sys 1 ogdlpAdd 
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systemVerification 


Runs  a  suite  of  diagnostic  tests  on  all  switches  in  a  fabric. 


Synopsis 

systemverif ication   [-parameters    |    -short]    [[-fru  type]    -unit  id] 

Availability 

admin 


Use  this  command  to  run  a  comprehensive,  system-wide  test  of  all  switches  in  a  system.  The  command 
initiates  a  burn-in  run  on  all  switches  within  the  current  system.  The  optional  -fru  and  -unit 
parameters  allow  you  to  focus  the  testing  to  a  single  blade  in  a  multiblade  system. 

The  run  can  be  terminated  by  issuing  a  Ctrl-C  from  the  initiating  terminal.  All  of  the  burn-in  features  are 
operational  during  the  systemVerification  command.  The  burninErrShow  displays  the  stored 
burn-in  errlogs;  the  logs  by  blade  are  saved  in  /var/log/verify .  slot  files.  On  fixed-port-count 
products,  the  slot  defaults  to  0. 

The  command  monitors  the  testing  and  terminates  the  burn-in  activity  if  all  the  elements  fail.  Each  failing 
slot  only  outputs  the  first  observed  failure.  Because  this  monitoring  is  a  polling  activity,  the  command 
number  output  might  not  be  the  exact  command  number  that  failed. 

After  the  testing  terminates,  the  burninStatus  command  output  displays,  and  the  burninErrShow 
messages  for  the  failing  slots  displays.  If  all  slots  pass,  then  only  the  burninStatus  command  output 
displays. 

The  burn-in  tests  are  designed  to  operate  with  switches  connected  to  a  fabric  and  restrict  the  frame 
loopback  to  inside  the  unit.  If  loopback  plugs  are  installed  in  all  ports,  the  burn-in  parameter 
min_lb_mode  can  be  changed  to  1  to  test  the  Fibre  Channel  through  the  loopback  plug. 


Description 


Operands 


This  command  has  the  following  operands: 


-short 


-parameters 


fru  type 


Invokes  the  diagSetCycle  command  before  starting  the 
burn-in  run.  This  allows  users  to  modify  the  burn-in  parameters 
prior  to  the  run.  These  diagSetCycle  parameters  are  copied 
to  all  switches  in  the  system  and  override  the  original  settings  in 
the  database.  If  the  diagSetCycle  parameters  are  not 
specified,  the  run  uses  the  previously  stored  values.  This  option 
does  not  perform  a  burninErrClear  operation  prior  to 
starting  the  testing  operation. 

Sets  the  burn-in  parameters  that  control  the  number  of  frames 
to  1 .  The  primary  use  for  this  command  is  software  regression 
testing,  or  quick  validation  that  all  hardware  is  operational.  The 
shorter  test  cycle  does  not  have  enough  test  time  to  detect 
intermittent  errors.  This  option  performs  a  burninErrClear 
operation  prior  to  starting  the  testing  operation. 

Use  to  focus  testing  on  a  single  FRU  in  the  system.  The  valid 
options  for  type  are  BLADE,  PS,  FAN,  and  WWN;  however, 
only  BLADE  is  supported  at  this  time.  Since  only  one  FRU  type  is 
supported,  this  parameter  is  optional,  but  -unit  is  required  for 
single  FRU  testing. 
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-unit  id  Use  to  focus  testing  on  a  single  FRU  in  the  system.  The  id  for  a 

FRU  type  of  BLADE  correlates  to  the  slot  number  of  the  FRU  to  be 
tested. 

Diagnostics 

Each  diagnostic  test  in  this  suit  might  report  its  own  set  of  error  messages  when  it  detects  failures.  See  the 
"Diagnostics"  section  of  individual  diagnostic  test  help  pages.  These  messages  are  available  only  in  the 
log  file. 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

Examples 

To  initiate  a  system  verification  test  on  all  switches  in  the  fabric: 

switch : admin>  systemverif ication  -short 

systemverif ication :   Setting  parameters  for  short  run. 
systemverif ication :  burnin  parameters. 
CURRENT   -   KEYWORD  :  DEFAULT 


1  -  number_of _runs  :  1 

2  -  vib       :  2 

10  -  thermal  :  10 

SYSTEMVERIFICATION  -  label    :  BURNIN 

2  -  min_lb_mode  :  2 

1  -  tbr_passes  :  1 

1  -  prt_on  :  1 

1  -  cntmem_on  :  1 

1  -  cmi_on  :  1 

1  -  retention_on  :  1 

1  -  cam_on  :  1 

1  -  flt_passes  :  50 

1  -  sta_passes  :  25 

1  -  plb_nframes  :  100 

1  -  txd_nframes  :  50 

1  -  xpt_nframes  :  200 

1  -  bpt_nframes  :  2  0 

1  -  slk_nmegs  :  50 

1  -  bpt_all_nf rames  :   3  0 

1  -  slk_all_nmegs  :  50 


systemverif ication :  Arming  the  burnin  run  on  switch  0. 
systemverif ication :   Starting  burnin  on  Switch  0 

systemverif ication :  Monitoring  progress  of  the  burnin  activity, 
systemverif ication :  Outputting  Status 

State  Status     Run  Cmd  TotCmds  Script 

COMPLETED  PASS         1  2  2  22  switchburnin . sh 
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See  also 

burninErrClear 
burninStatus 
diagSetBurnin 
diagSetCycle 
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tempShow 

Displays  temperature  readings. 

Synopsis 

tempshow 

Availability 

all  users 

Description 

Use  this  command  to  display  the  current  temperature  readings  of  all  temperature  sensors  in  a  switch.  For 
each  sensor,  this  command  displays  the  slot  number  (if  applicable),  the  sensor  state,  and  the  temperature. 
The  temperature  readings  are  given  in  both  Centigrade  and  Fahrenheit. 

See  the  hardware  reference  manual  for  your  switch  to  determine  the  normal  temperature  range. 

Operands 

none 

Examples 

To  display  temperature  and  status  sensors: 


switch: user >  tempshow 

Index 

Slot 

State 

Centigrade 

Fahrenheit 

1 

1 

Ok 

41 

105 

2 

2 

Ok 

39 

102 

3 

3 

Absent 

4 

4 

Absent 

5 

5 

Ok 

26 

78 

6 

6 

Ok 

27 

80 

See  also 

f anShow 
psShow 
sensorShow 
slotShow 
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timeout 

Sets  or  displays  the  idle  timeout  value  for  a  login  session. 

Synopsis 

timeout  [timeval] 

Availability 

admin  (set  and  display) 

all  users  (display  only) 
Description 

Use  this  command  without  an  operand  to  display,  in  minutes,  the  current  timeout  value  after  which  idle 
logins  are  automatically  terminated. 

Use  this  command  with  the  timeval  operand  to  set  the  login  timeout  value  to  the  specified  interval.  A 
value  of  0  disables  timeout  functionality  of  login  sessions. 

Operands 

This  command  has  the  following  operand: 

timeval  Specify  the  number  of  minutes  for  the  Telnet  timeout  value.  Valid  values  are  1  to 

99,999,  or  0  to  disable  login  timeouts.  This  operand  is  optional;  if  omitted,  the 
command  displays  the  current  timeout  value. 

Examples 

To  set  the  idle  timeout  to  10  minutes: 

switch : admin>  timeout  10 

IDLE  Timeout  Changed  to  10  minutes 

The  modified  IDLE  Timeout  will  be  in  effect  after  NEXT  login 

See  also 

none 
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topologyShow 


Displays  the  unicast  fabric  topology. 


Synopsis 


topologyshow  [domain] 


Availability 

all  users 


Description 

Use  this  command  to  display  the  fabric  topology,  as  it  appears  to  the  local  switch,  including: 

•  A  list  of  all  domains  that  are  part  of  the  fabric,  and  to  each  of  those  domains,  all  possible  paths  from 
the  local  switch. 

•  For  each  path  cost,  the  number  of  hops  from  the  local  switch  to  the  destination  switch  and  a  summary 
of  all  ports  are  routed  through  that  path. 


The  display  contains  the  following  fields: 

Local  Domain  ID 
Domain 
Metric 
Name 


Path  Count 
Hops 
Out  Port 

In  Ports 

Total  Bandwidth 
Bandwidth  Demand 
Flags 


Domain  number  of  local  switch. 

Domain  number  of  destination  switch. 

Cost  of  reaching  destination  domain. 

The  name  of  the  destination  switch. 

The  number  of  currently  active  paths  to  the  destination  domain. 

The  maximum  number  of  hops  to  reach  destination  domain. 

Port  to  which  incoming  frame  are  forwarded  to  reach  the 
destination  domain. 

Input  ports  that  use  the  corresponding  out  port  to  reach  the 
destination  domain.  This  is  the  same  information  provided  by 

portRouteShow  and  uRouteShow. 

The  maximum  bandwidth  of  the  out  port. 

The  maximum  bandwidth  demand  by  the  in  ports. 

Always  D,  indicating  a  dynamic  path.  A  dynamic  path  is 
discovered  automatically  by  the  FSPF  path  selection  protocol. 


Operands 


This  command  has  the  following  operand: 


domain 


Specify  the  destination  domain  for  which  topology  information  is 
to  be  displayed.  This  operand  is  optional;  if  omitted,  this 
command  displays  the  topology  information  of  all  the  domains 
in  the  fabric. 
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Examples 

To  display  the  unicast  fabric  topology: 


switch : admin>  topologyshow 

2  domains  in  the  fabric;  Local 

Domain  ID:  1 

Domain :  6 

Metric:  500 

Name:  switch 

Path  Count:  4 

Hops  : 

1 

Out  Port: 

60 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

61 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

62 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

Hops  : 

1 

Out  Port: 

58 

In  Ports: 

None 

Total  Bandwidth: 

2  Gbps 

Bandwidth  Demand: 

0  % 

Flags : 

D 

See  also 

portRouteShow 
uRouteShow 
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trace  Dump 

Displays,  initiates,  or  removes  a  trace  dump. 

Synopsis 

tracedump   [-S]    [-s  slot] 
tracedump  -n   [-s  slot] 
tracedump  -r   [-s  slot] 

Availability 

admin 

Description 

Use  this  command  to  initiate  a  background  trace  dump,  to  remove  the  content  of  a  trace  dump,  or  to 
display  the  dump  status  on  the  switch. 


NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  traceDump  -S. 
t— I    The  default  remote  file  name  format  is  ch assisn ame-S # ■  YYYYMMDDHHMMSS. dmp,  in  which  #  is  the  sic 
number  (0  on  nonbladed  systems),  and  yyyymmddhhmmss  (year-month-day-hour-minute-second)  is  the 
trace  dump  time. 


Operands 

This  command  has  the  following  mutually  exclusive  operands: 


-r 


-S 


-n 


Displays  dump  status. 

Initiates  a  background  trace  dump. 

Removes  the  content  of  a  trace  dump. 


This  command  has  the  following  optional  operand: 


--s  slot 


Specifies  the  slot  number  from  which  a  trace  dump  is  generated.  If  this  is 
not  supplied,  the  trace  dump  is  generated  from  the  local  slot. 


Examples 


To  initiate  a  background  trace  dump  from  slot  5: 


switch : admin>  tracedump  -n  -s  5 


To  remove  a  trace  dump: 


switch : admin>  tracedump  -r 


trace  dump  removed 


See  also 


supportFtp 


supportSave 


supportShow 
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traceFtp 
traceTrig 
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traceFtp 


Displays,  enables,  or  disables  the  trace  auto-FTP,  or  retrieves  the  trace  dump  file. 


Synopsis 


traceftp  [-S] 
traceftp  -e 
traceftp  -d 

traceftp  -n  [-s  slot]  [-h  hostip]  [-u  username]  [-p  password] 
[-d  remotedirectory]    [-f  remotefile] 


Availability 

admin 

Description 

Use  this  command  to  display,  enable,  or  disable  trace  auto-FTP  or  to  retrieve  a  trace  dump  file  from  the 
switch  to  the  FTP  site  immediately. 


NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  traceFtp  -S.  Default  remote  file 
name  format  for  traceFtp  -n  is  swi  tchname-S# -YYYYMMDDHHMMSS . dmp,  where  #  is  the  slot 
number  (0  if  it  is  on  nonbladed  system),  and  yyyymmddhhmmss  is  trace  dump  time 
(year-month-day-hour-minute-second). 


Operands 


This  command  has  the  following  mutually  exclusive  operands: 


-e 


-S 


-d 


Displays  the  trace  auto-FTP  feature. 
Enables  the  trace  auto-FTP  feature. 
Disables  the  trace  auto-FTP  feature. 


-n 


Retrieves  a  trace  dump  file  from  the  switch  immediately.  The  -n  option  has  the  following 
optional  operands: 
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-s  slot 


■h  hostip 


■u  username 


-p  password 


■d  remotedirectory 


■f  remote  file 


Specifies  the  slot  number  from  which  a  trace  dump  is 
generated.  If  this  is  not  supplied,  the  trace  dump  is  generated 
from  the  local  slot. 

Specifies  the  FTP  host  IP  address.  It  must  be  an  IP  address. 
hostip  should  be  less  than  48  characters. 

Specifies  the  FTP  user  name,  username  should  be  less  than 
48  characters. 

Specifies  the  FTP  user  password.  If  the  user  name  is 
anonymous,  the  password  is  not  needed,  password  should 
be  less  than  48  characters. 

Specifies  the  remote  directory  in  which  to  store  a  trace  dump 
file.  traceFtp  cannot  take  a  slash  (  /  )  as  a  directory  name. 
remotedirectory  should  be  less  than  48  characters. 

Specifies  the  remote  file  in  which  to  store  a  trace  dump  file. 
remote  file  should  be  less  than  48  characters. 


Examples 

To  retrieve  a  trace  dump  file: 

switch : admin>  traceftp  -n  -h  192.168.67.126  -u  anonymous  -d  tracedump  -f 
dumpf ile 

ftp  trace  dump  file  in  progress... 
ftp  trace  dump  file  succeeded 

To  enable  the  auto-FTP  feature: 


switch : admin>  traceftp  -e 
trace  auto-FTP  enabled 

To  disable  the  auto-FTP  feature: 

switch : admin>  traceftp  -d 
trace  auto-FTP  disabled 


See  also 

supportFtp 

supportSave 

supportShow 

traceDump 

traceTrig 
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traceTrig 

Sets,  removes,  or  displays  trace  triggers. 

Synopsis 

tracetrig   [-S]    [-s  slot] 
tracetrig  -a   [-s  slot]  msgid 
tracetrig  -r    [-s  slot]  msgid 
tracetrig  -R   [-s  slot] 

Availability 

admin 

Description 

Use  this  command  to  set,  remove,  or  display  trace  triggers  for  the  specified  slot  on  the  switch. 
NOTE:    If  there  is  no  parameter  specified,  this  command  defaults  to  tracetrig  -S. 


Operands 

This  command  has  the  following  mutually  exclusive  operands: 

-S  Displays  trace  triggers  for  the  specified  slot, 

-a  Sets  a  trace  trigger  for  the  specified  slot, 

-r  Removes  a  trace  trigger  from  the  specified  slot. 

-R  Removes  all  trace  triggers  from  the  specified  slot. 

■This  command  has  the  following  optional  operand: 

-s  slot  Specifies  the  slot  number  from  which  a  trace  dump  is  generated.  If  this 

is  not  supplied,  the  trace  dump  is  generated  from  the  local  slot. 

The  -a  and  -r  options  also  have  the  following  required  operand: 

msgid  Specifies  the  trigger  number,  using  the  RASLog  message  ID.  This 

operand  is  required. 

Examples 

To  set  a  trace  trigger: 

switch : admin>  tracetrig  -a  NS-1001 
trace  trigger [NS-1001]    is  added 

To  remove  a  trace  trigger: 

switch : admin>  tracetrig  -r  NS-1001 
trace  trigger [NS-1001 ]    is  removed 
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To  remove  all  trace  triggers: 


switch : admin>  tracetrig  -R 
all  trace  triggers  are  removed 

See  also 

supportFtp 

supportSave 

supportShow 

traceFtp 

traceFtp 
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trackChangesHelp 

Displays  information  on  track-changes  feature  commands. 

Synopsis 

trackchangeshelp 

Availability 

all  users 

Description 

Use  this  command  to  display  information  about  the  track-changes  commands. 

Examples 

To  display  information  on  the  track-changes  feature  commands: 

switch : admin>  trackchangeshelp 

trackChangesSet  Configure  alert  for  login/logout/conf ig  update 
trackChangesShow      Displays  status  of  track  changes 

See  also 

trackChangesSet 
trackChangesShow 
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trackChangesSet 

Enables  or  disables  configuring  of  track-changes  feature. 

Synopsis 

trackchangesset   [mode]  [ ,  snmptrapmode] 

Availability 

admin 

Description 

This  command  enables  or  disables  the  track-changes  feature.  An  SNMP-TRAP  mode  can  also  be  enabled. 
Trackable  changes  are: 

•  Successful  login 

•  Unsuccessful  login 

•  Logout 

•  Config  file  change  from  task 

•  Track  changes  on 

•  Track  changes  off 

The  output  from  the  track-changes  feature  is  dumped  to  the  error  log  for  the  switch.  Use  the  errDump 
command  or  the  errModuleShow  command  to  view  the  error  log. 

Operands 

This  command  has  the  following  operands: 

mode  Specify  1  to  enable  the  track-changes  feature  or  specify  0  to 

disable  the  feature.  The  default  (if  no  operand  is  specified)  is  to 
disable  the  track-changes  feature.  This  operand  is  optional. 

snmptrapmode  Specify  1  to  enable  errors  to  be  sent  to  the  SNMP-TRAP  in 

addition  to  the  errlog  or  specify  0  to  disable  the  SNMP-TRAP 
messages.  The  default  (if  no  operand  is  specified)  is  to  disable 
SNMP-TRAP  messages.  This  operand  is  optional. 

Examples 

To  enable  the  track-changes  feature: 

switch : admin>  trackchangesset  1,  1 
Committing  configuration ...  done . 
switch : admin>  trackchangesshow 
Track  changes  status :  ON 
Track  changes  generate  SNMP-TRAP :  YES 
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See  also 

agtCfgSet 
agtCf gShow 
trackChangesHelp 
trackChangesShow 
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trackChangesShow 


Displays  status  of  track-changes  feature. 

Synopsis 

trackchangesshow 

Availability 

all  users 

Description 

Use  this  command  to  display  status  of  the  track-changes  feature.  It  displays  if  the  feature  is  turned  on  or 
off  and  if  SNMP  traps  are  generated. 

The  output  from  the  track-changes  feature  is  dumped  to  the  error  log  for  the  switch.  Use  the  errDump 
command  or  the  errModuleShow  command  to  view  the  error  log. 

Operands 

none 

Examples 

To  display  the  status  of  the  track-changes  feature: 

switch : admin>  trackchangesshow 

Track  changes  status :  ON 

Track  changes  generate  SNMP-TRAP :  YES 

See  also 

trackChangesHelp 
trackChangesSet 


Fabric  OS  5.x  command  reference  guide  723 


trunkDebug 

Debugs  a  trunk  link  failure. 

Synopsis 

trunkdebug  portl  port2 

Availability 

admin 

Description 

Use  this  command  to  debug  a  trunk  link  failure.  This  command  reports  one  of  the  following  messages, 
based  on  the  trunking  properties  of  the  two  specified  ports: 

•  Switch  does  not  support  trunking 

•  Trunking  license  required 

•  Trunking  not  supported  in  switch  interop  mode 

•  port  port_id  is  not  E_Port 

•  port  port_id  trunking  disabled 

•  port  port_id  speed  is  not  2G  or  4G 

•  port  port_id  and  port  port_id  are  not  on  same  port  group 

•  port  port_id  and  port  port_id  connect  to  different  switches 

•  port  port_id  is  not  a  trunking  port  due  to:   E_Port  being  disabled,  or 
trunking  might  be  disabled  at  remote  port 

•  port  port_id  and  port  port_id  cannot  trunk,   please  check  link  length  to 
make  sure  difference  is  less  than  400m 

Operands 

This  command  has  the  following  operands: 

portl  Specify  the  area  number  of  port  1 .  Use  the  switchShow  command  to  view 

the  area  numbers  for  a  port.  This  operand  is  required. 

port2  Specify  the  area  number  of  port  2.  Use  the  switchShow  command  to  view 

the  area  numbers  for  a  port.  This  operand  is  required. 

Examples 

To  debug  a  trunk  connection: 

switch : admin>  trunkdebug  43  44 
Switch  does  not  support  trunking 

switch : admin>  trunkdebug  62  63 
port  62  and  63  are  trunked  together 
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See  also 

portCf gTrunkPort 
switchCf gTrunk 
trunkShow 
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trunkShow 

Displays  trunking  information. 

Synopsis 

trunkshow 

Availability 

all  users 

Description 

Use  this  command  to  display  trunking  information.  The  following  fields  appear: 

Trunking  Group  Number     Displays  each  trunking  group  on  a  switch.  All  the  ports  that  are  part  of 

this  trunking  group  are  displayed. 

Port  to  port  connections       Displays  the  port-to-port  trunking  connections. 

WWN  Displays  the  WWN  of  the  connected  port. 

deskew  The  time  difference  for  traffic  to  travel  over  each  ISL  compared  to  the  time 

to  the  shortest  ISL  in  the  group.  The  number  corresponds  to  nanoseconds 
divided  by  10.  The  firmware  automatically  sets  the  minimum  deskew 
value  of  the  shortest  ISL  to  15. 

Master  Displays  whether  this  trunking  port  connection  is  the  master  port 

connection  for  the  trunking  group. 

Operands 

none 

Examples 

To  display  trunking  information  for  a  switch: 


switch 

: admin> 

trunkshow 

1:  6 

-> 

4 

10 

00 

00: 

60 

69 

51 

43 

04 

deskew 

15 

MASTER 

2  : 15 

-> 

13 

10 

00 

00  : 

60 

69 

51 

43 

04 

deskew 

16 

MASTER 

12 

-> 

12 

10 

00 

00: 

60 

69 

51 

43 

04 

deskew 

15 

14 

-> 

14 

10 

00 

00: 

60 

69 

51 

43 

04 

deskew 

17 

13 

-> 

15 

10 

00 

00  : 

60 

69 

51 

43 

04 

deskew 

16 

3  :24 

-> 

14 

10 

00 

00: 

60 

69 

51 

42 

dd 

deskew 

15 

MASTER 

See  also 

portCf gTrunkPort 
switchCf gTrunk 
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tsClockServer 


Displays  or  sets  the  NTP  server  address. 

Synopsis 

tsclockserver  [ipaddr] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  synchronize  the  local  time  of  the  principal  or  primary  FCS  switch  to  an  external  NTP 
server. 

The  time  server  daemon  synchronizes  fabric  time  by  sending  updates  of  the  principal  or  primary  FCS 
local  switch  time  periodically  to  every  switch  in  the  fabric.  The  time  server  daemon  runs  on  all  switches  in 
the  fabric,  but  only  the  principal  switch  (when  the  security  feature  is  not  enabled)  or  the  primary  FCS 
switch  (when  the  security  feature  is  enabled)  connect  to  the  NTP  server  and  broadcast  time  service 
updates. 

All  switches  in  the  fabric  maintain  the  current  clock  server  IP  address  in  flash  memory.  By  default,  this 
value  is  LOCL.  Changes  to  the  clock  server  IP  address  on  the  principal  or  primary  FCS  switch  are 
propagated  to  all  switches  in  the  fabric. 

Use  this  command  with  no  parameters  to  display  the  current  clock  server  IP  address  being  used.  Specify 
the  ipaddr  operand  to  set  the  clock  server  IP  address  and  enable  fabric-wide  clock  synchronization  with 
the  specified  clock  server. 

The  NTP  server  used  must  support  a  full  NTP  client.  Fabric  OS  3.1 .0  and  2.6.1  have  an  SNTP  client  and 
hence  will  accept  an  SNTP  or  NTP  server,  but  v4.1 .0  has  an  NTP  client,  so  for  the  proper  functioning  of 
a  mixed  fabric  with  external  time  synchronization  it  is  necessary  that  an  NTP  server  that  supports  a  full 
NTP  client  be  used. 

The  ipaddr  specified  should  be  the  IP  address  of  an  NTP  server  and  should  be  accessible  from  the 
switch.  When  a  clock  server  IP  address  other  than  LOCL  is  specified  but  is  not  used  by  the  fabric,  a 
warning  is  displayed  and  logged.  When  a  clock  server  IP  address  other  than  LOCL  is  specified,  the  date 
command  is  restricted  to  display  only.  See  the  date  command  for  more  details. 

"2^Jf  NOTE:   When  secure  mode  is  enabled,  this  command  can  be  run  on  all  switches  to  view  the  NTP  server 
IP  address.  You  can  only  modify  the  NTP  server  IP  address  on  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operand: 

ipaddr  Specify  the  IP  address  of  the  NTP  server.  This  operand  is 

optional.  By  default,  this  value  is  LOCL. 

If  no  operand  is  specified,  the  current  value  appears. 
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Examples 

To  display  the  current  clock  server  value  (LOCL),  set  the  value  to  an  NTP  server  at  the  specified  IP  address 
and  then  verify  that  the  new  IP  address  was  saved: 


switch : admin>  tsclockserver 

LOCL 

switch : admin>  tsclockserver  "123.123 

.  123  . 123  " 

Updating  Clock  Server  configuration. 

. . done . 

switch : admin>  tsclockserver 

123  . 123  . 123 . 123 

See  also 

date 
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tsTimeZone 


Displays  or  sets  the  system  time  zone. 

Synopsis 

tstimezone   [houroffset   [,  minuteoffset] ] 

Availability 

all  users  (display) 

admin  (set) 
Description 

Use  this  command  to  display  or  set  the  system  time  zone. 

All  switches  maintain  the  current  time  zone  setup  in  flash  memory.  Changing  the  time  zone  on  a  switch 
updates  the  local  time  zone  setup  and  is  reflected  in  local  time  calculations. 

All  switches  are  by  default  in  the  0,0  time  zone:  that  is,  GMT.  If  all  switches  in  a  fabric  are  in  one  time 
zone,  it  is  possible  to  leave  the  time  zone  setup  at  the  default. 

Time  zone  is  used  only  in  computing  local  time,  which  is  used  for  error  reporting  and  logging.  An 
incorrect  time  zone  setup  do  not  affect  the  switch  operation  in  any  way. 

System  services  started  during  the  switch  bootup  reflect  a  time-zone  change  only  at  the  next  reboot. 

Enter  this  command  with  no  parameters  to  display  the  time  zone  setup.  With  the  valid  parameters,  it  sets 
the  time  zone  for  an  individual  switch. 

Negative  houroffset  values  mean  the  local  time  is  behind  GMT;  for  example:  -8,0  is  GMT-08:00 
Positive  houroffset  values  mean  the  local  time  is  ahead  of  GMT;  for  example:  3,  0  is  GMT+03:00 

f-^f  NOTE:    In  systems  with  multiple  switches  in  a  single  chassis,  the  time  zone  of  switch  0  is  the  system  time 
zone. 


Operands 

This  command  has  the  following  operands: 

houroffset  Specify  the  number  of  hours  relative  to  GMT.  This  operand  must  be 

specified  as  an  integer.  Valid  values  are  -1 2  through  1  2.  This  operand 
is  optional. 

minuteoffset        Specify  the  number  of  minutes  relative  to  houroffset.  This  operand 
must  be  specified  as  an  integer.  Valid  values  are  -30,  0,  or  30.  This 
operand  is  optional. 
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Example 

To  display  the  current  time  zone  setup  and  then  change  it  to  GMT-3:30: 

switch : admin>  tsTimeZone 
Time  Zone  Hour  Offset:  0 
Time  Zone  Minute  Offset:  0 

switch : admin>  tsTimeZone  -3,    -3  0 

Updating  Time  Zone  configuration ...  done . 

System  Time  Zone  change  will  take  effect  at  next  reboot. 

switch : admin>  tsTimeZone 
Time  Zone  Hour  Offset:  -3 
Time  Zone  Minute  Offset:  -30 

See  also 

date 
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turboRamTest 

Performs  a  turbo  SRAM  logic  test  for  2  Gb/s  ASICs. 

Synopsis 

turboramtest   [--slot  slotnumber]  [-passcnt  count]  [-ports  itemlist] 

Availability 

admin 


This  command  verifies  the  on  chip  SRAM  located  in  the  2  Gb/s  ASIC  using  the  turbo-RAM  BIST  circuitry. 
These  same  SRAMS  are  tested  by  portRegTest  and  sramRetentionTest  using  PCI  operations  but 
for  this  test,  the  BIST  controller  is  able  to  perform  the  SRAM  write  and  read  operations  at  a  much  faster 
rate.  It  is  also  able  to  test  one  SRAM  in  each  quadrant  of  every  chip,  in  parallel. 

The  test  flow  for  each  SRAM  is  as  follows: 

1.  Fill  RAM  with  alternating  FFFF  0000  pattern.  (Subtest  1 :  turboram  memory  fill) 

2.  For  each  incrementing  address,  read  FFFF  0000  pattern  and  write  0000  FFFF.  (Subtest  2:  turbo-ram 
r-m-w  inc  1 ) 

3.  For  each  incrementing  address,  read  0000  FFFF  pattern  and  write  FFFF  0000.  (Subtest  3:  turbo-ram 
r-m-w  inc  2) 

4.  For  each  decrementing  address,  read  FFFF  0000  pattern  and  write  0000  FFFF.  (Subtest  4:  turbo-ram 
r-m-w  dec  1 ) 

5.  For  each  decrementing  address,  read  0000  FFFF  pattern  and  write  FFFF  0000.  (Subtest  5:  turbo-ram 
r-m-w  dec  2) 

6.  Repeat  Steps  1-5  with  AAAA  5555  pattern. 


Description 


Operands 


This  command  has  the  following  operands: 


-passcnt  count 


--slot  slotnumber 


ports  itemlist 


Specifies  the  slot  number  on  which  the  diagnostic  operates.  The 
ports  specified  are  relative  to  this  slot  number.  The  default  is  0 
and  designated  to  operate  on  fixed-port-count  products. 

Specify  the  number  of  times  to  perform  this  test.  The  default  value 
is  1 .  This  operand  is  optional. 

Specify  a  list  of  blade  ports  to  test.  By  default,  all  the  blade  ports 
in  the  specified  slot  are  tested.  See  the  itemList  command 
help  page  for  more  information.  This  operand  is  optional. 


Examples 


To  execute  this  test: 


switch :admin>  turboramtest  -passcnt  2  -ports  2/0-2/63 


Running  Turbo  RAM  Test 


passed . 
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Diagnostics 

When  it  detects  failures,  the  subtest  might  report  one  or  more  of  the  following  error  messages: 

DIAG-WTEST 
DIAG-INC_RWTEST 
DIAG-DEC_RWTEST 
DIAG-RAMINIT_TO 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide 
more  information. 

See  also 

centralMeraoryTest 

cmeraRetentionTest 

cmiTest 

portRegTest 

sraraRetentionTest 
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txdPath 

Performs  a  functional  test  of  ASIC  pair  TXA,TXD  connections. 

Synopsis 

txdpath   [--slot  slotnumber]  [-nframes  count] [-lb_mode  mode]  [-spd_mode 
mode]  [-nonstop  mode]  [-ports  itemlist] 

Availability 

admin 

Description 

Use  this  command  to  verify  the  TXA,  TXD,  and  CMI  data  paths  between  the  chips  within  a  mini-switch. 
This  is  done  by  configuring  all  of  the  ports  on  the  mini-switch  in  internal  loopback  and  sending  a  frame 
from  each  quadrant  to  each  other  port  on  the  same  mini-switch.  The  frame  starts  from  the  CPU  and  is 
transmitted  by  the  first  port  which  also  receives  the  frame  and  deposits  it  in  central  memory.  The  second 
port  then  reads  the  frame  from  central  memory  using  its  own  TXA, TXD  path.  The  frame  is  then  looped 
back  one  more  time  and  is  sent  back  to  the  CPU,  where  it  is  compared  with  the  transmitted  data. 

Only  one  frame  is  transmitted  and  received  at  any  one  time.  External  cable  is  not  required  to  run  this  test. 
The  port  LEDs  flicker  green  rapidly  while  the  test  is  running.  The  test  method  is  as  follows: 

1.  Set  all  ports  present  for  parallel  loopback.  Then,  for  each  pair  of  source  quadrants  and  destination 
ports: 

2.  Set  up  a  source  port  to  route  frames  to  a  destination  port  and  a  destination  port  to  route  frames  to  the 
CPU. 

3.  Transmit  frame  F  through  the  source  port. 

4.  Pick  up  the  frame  from  the  destination  port. 

5.  Check  if  any  of  the  eight  statistic  error  counters  are  not  0: 

ENC_in,   CRC_err,   TruncFrm,   FrmTooLong ,   BadEOF,   Enc_out,   BadOrdSet,  DiscC3 

6.  Repeat  steps  2  through  5  for  all  ports  present  until  either  the  number  of  frames  (or  -nmegs  count) 
requested  is  reached,  or,  all  ports  are  marked  bad. 

At  each  pass,  a  different  data  type  is  used  to  create  the  frame  from  a  palette  of  seven;  meaning  if  a  pass 
of  seven  is  requested,  seven  different  frames  are  used  in  the  test.  If  eight  passes,  the  first  seven  frames  are 
unique,  and  the  eighth  is  the  same  as  the  first.  The  data  palette  of  seven  are: 

1.  CSPAT:  0x7e,  0x7e,  0x7e,  0x7e,  ... 

2.  BYTEJ.FSR:  0x69,  0x01,  0x02,  0x05,  ... 

3.  CHALF_SQ:  0x4a,  0x4a,  0x4a,  0x4a,  ... 

4.  QUAD_NOT:  0x00,  Oxff,  0x00,  Oxff,  ... 

5.  CQTR_SQ:  0x78,  0x78,  0x78,  0x78,  ... 

6.  CRPAT:  Oxbc,  Oxbc,  0x23,  0x47,  ... 

7.  RANDOM:  0x25,  0x7f,  0x6e,  0x9a,  ... 

If  seven  passes  are  requested,  the  seven  different  data  types  are  used  in  the  test.  If  eight  passes  are 
requested,  the  first  seven  frames  use  unique  data  type. 
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Operands 


—  slot 
slotnumber 

-nmegs  count 
-lb  mode  mode 


This  command  has  the  following  operands:- 

Specifies  the  slot  number  that  the  diagnostic  will  operate  on.  The  ports 
specified  will  be  relative  to  this  slot  number.  The  default  is  set  to  0  and  designed 
to  operate  on  fixed-port-count  products. 

Specifies  the  number  of  frames  to  send  in  millions.  The  test  progresses  until  the 
specified  number  of  frames  transmits  on  each  port.  The  default  value  is  1 0, 
which  represents  10  million  frames. 

Select  the  loopback  point  for  the  test.  By  default,  spinJitter  uses  port 
loopback. 

0  Cable  loopback 

1  Port  loopback  (loopback  plugs) 

2  External  (SERDES)  loopback 

3  Silkscreen  loopback 

5  Internal  (parallel)  loopback 

Specifies  the  speed  mode  for  the  test.  This  parameter  is  used  for 
Bloom  and  Condor  ASIC-based  products  only,  for  which  it  controls 
the  speed  at  which  each  port  operates.  For  lG-only  products,  this 
parameter  is  ignored.  The  exact  operation  of  modes  5  through  8 
depends  on  the  loopback  mode  selected.  When  speed  modes  5 
through  8  are  used  with  cables,  they  must  be  connected 
EVEN->ODD  or  the  test  fails. 

Run  test  at  1  Gb/s,  2  Gb/s,  and  4  Gb/s. 


-spd_mode  mode 


0 
1 

2 
3 


Run  test  at  1  Gb/s. 

Run  test  at  2  Gb/s  (Bloom  default). 

Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 


4  In  test  at  4  Gb/s  (Condor  default).  For  -lb_mode  set  to  0, 1 ,  the 

following  speed  modes  are  available  to  test  the  speed  negotiation. 

For  -lb_mode  set  to  0  or  1 ,  the  following  speed  modes  are  available  to  test 
the  speed  negotiation: 

3  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  1  Gb/s. 

4  Set  all  even  ports'  speed  for  autonegotiate.  Set  all  odd  ports'  speed 
for  2  Gb/s. 

5  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  1  Gb/s. 

6  Set  all  odd  ports'  speed  for  autonegotiate.  Set  all  even  ports'  speed 
for  2  Gb/s. 

For  -lb_mode  set  to  2,3,  the  following  speed  modes  are  available  to  test  FIFO 
underrun. 

3,5 


4,6 


Set  all  even  ports'  speed  for  2  Gb/s.  Set  all  odd  ports'  speed  for 

1  Gb/s. 

Set  all  even  ports'  speed  for  1  Gb/s.  Set  all  odd  ports'  speed  for 

2  Gb/s. 
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--nonstop  mode     Specify  nonstop  mode.  If  set  to  a  nonzero  value,  the  test  does  not  stop  on  the 
first  error.  The  default  value  is  0. 

-ports  Specify  a  list  of  user  ports  to  test.  By  default,  all  of  the  user  ports  in  the  current 

itemlist  switch  are  tested.  This  option  might  be  used  to  restrict  testing  to  the  specified 

ports. 

Examples 

To  run  the  txdPath  test: 

switch : admin>  txdpath 

Running  TX  Data  Path  Test  .... 

Test  Complete:    "txdpath"  Pass  10  of  10 

Duration  0  hr,    0  min  &  47  sec  (0:0:47:645). 

Diagnostics 

When  it  detects  failures,  the  test  can  report  one  or  more  of  the  following  error  messages: 

DATA 

ERRSTAT 

INIT 

PORTDIED 
STATS 
TIMEOUT 
XMIT 

See  the  HP  StorageWorks  Fabric  OS  5.x  diagnostics  and  system  error  messages  reference  guide  for 
more  information. 

See  also 

backport 
camTest 

centralMemoryTest 
cmeraRe  tentionTest 
cmiTest 
crossPortTest 
itemList 

portLoopbackTest 

portRegTest 

spinSilk 

sramRe tentionTest 
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upTime 

Displays  length  of  time  the  system  has  been  operational. 

Synopsis 

uptime 

Availability 

all  users 

Description 

upTime  provides  a  one  line  display  of  the  following  information.  The  current  time,  how  long  the  system 
has  been  running,  how  many  users  are  currently  logged  on,  and  the  system  load  averages  for  the  past  1 , 
5,  and  15  minutes. 

For  up  and  powered-on  times  less  than  60  seconds,  the  time  is  displayed  in  seconds.  For  times  greater 
than  or  equal  to  60  seconds,  the  time  is  displayed  in  minutes.  The  output  format  adjusts  accordingly. 

Operands 

none 

Examples 

To  display  the  length  of  time  the  system  has  been  operational: 

switch : admin>  uptime 

12:03am    up     4:56,     3  users,     load  average:   1.17,    1.08,  1.08 

See  also 

date 

f astBoot 

reboot 
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uRouteConfig 

Configures  a  static  route. 

Synopsis 

urouteconfig  in_area  domain  out_area 


Availability 

admin 


Description 

Use  this  command  to  configure  static  routes.  A  static  route  is  a  route  that  is  assigned  to  a  specific  path 
(defined  by  port  number  out_area),  and  does  not  change  when  a  topology  change  occurs  unless  the 
path  used  by  the  route  becomes  unavailable. 

After  this  command  is  issued,  if  out_area  is  associated  with  a  valid  minimum-cost  path,  all  frames 
coming  in  from  in_area  port  addressed  to  domain  are  forwarded  through  out_area  port. 

If  port  number  out_area  is  not  associated  with  such  a  path,  the  routing  assignment  is  not  immediately 
affected  by  this  command.  However,  the  static  route  is  remembered  so  that  it  can  be  enforced  if  this  port 
becomes  the  port  of  a  valid  path  in  the  future. 

If  a  static  route  requires  some  hardware  resources  that  are  already  used,  a  platform  conflict  warning 
message  is  displayed  and  the  configuration  does  not  take  effect. 

The  in_area  port  can  be  either  an  F_Port  or  an  E_Port. 


"2^f  NOTE:   When  using  static  routes,  load  sharing  might  be  affected.  The  switch  attempts  to  achieve 

optimum  load  sharing,  but  if  too  many  routes  are  statically  configured  to  use  the  same  out_area  port,  a 
fair  load  sharing  might  not  be  achievable. 

To  prevent  routing  loops,  static  route  requests  involving  non-minimum-cost  paths  are  not  enforced. 


Operands 

This  command  has  the  following  operands: 

in_area  Specify  the  port  to  be  statically  routed. 

domain  Specify  the  destination  domain. 

out_area  Specify  the  output  port  to  which  traffic  is  forwarded. 
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Examples 

To  configure  a  static  route  for  all  traffic  coming  in  from  port  1  and  addressed  to  domain  2  to  go  through 
port  5 : 


switch : admin>  urouteconfig  1  2 

5 

done . 

switch : admin>  urouteshow  1/1  2 

Local  Domain  ID:  1 

In  Port        Domain        Out  Port 
Port) 

Metric 

Hops 

Flags 

Next  (Dom, 

12  5 

500 

1 

S 

2,5 

See  also 

conf igShow 
interf aceShow 
uRouteRemove 
uRouteShow 
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u  Route  Re  move 

Removes  a  static  route. 

Synopsis 

urouteremove  in_area  domain 

Availability 

admin 

Description 

Use  this  command  to  remove  a  previously  configured  static  route. 

After  this  command  is  issued,  the  route  to  domain  for  in_area  might  change  to  use  a  different  output 
port,  if  dynamic  load  sharing  (DLS)  is  set.  If  DLS  is  not  set,  the  route  remains  as  is,  with  its  route  attribute 
changed  from  static  to  dynamic. 

Operands 

This  command  has  the  following  operands: 

in_area  Specify  the  F_Port  or  E_Port  input  port  of  the  static  route  to  remove. 

domain  Specify  the  destination  domain  of  the  static  route  to  remove. 

Examples 

To  remove  a  static  route  for  all  traffic  coming  in  from  port  1  and  addressed  to  domain  2: 

switch : admin>  urouteremove  1  2 
done . 

See  also 

dlsShow 
conf igShow 
uRouteConf ig 
uRouteShow 
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uRouteShow 


Displays  unicast  routing  information. 


Synopsis 


urouteshow   [ si otn umber I ]  [portnumber]  [,  domainnumber] 


Availability 

all  users 

Description 

Use  this  command  to  display  the  unicast  routing  information  for  a  port,  as  it  is  known  by  the  FSPF  path 
selection  and  routing  task.  The  routing  information  describes  how  a  frame  that  is  received  from  a  port  on 
the  local  switch  is  to  be  routed  to  reach  a  destination  switch. 

The  following  information  appears: 


Local  Domain  ID 
In  Port 


Domain 
Out  Port 


Metric 
Hops 

Flags 

Next  (Dom,  Port) 


Domain  number  of  local  switch. 

Port  from  which  a  frame  is  received.  Except  for  the  cases  in 
which  you  perform  a  port  swap  or  enable  extended-edge  PID 
(PID  Format  2)  on  a  switch,  the  value  is  equal  to  the  Area  field 
displayed  by  the  switchShow  command.  See  HP 
StorageWorks  Fabric  OS  5.x  Fabric  Watch  administrator's 
guide  for  more  information  regarding  the  extended-edge  PID 
format. 

Destination  domain  of  incoming  frame. 

Port  to  which  the  incoming  frame  is  to  be  forwarded.  Except  for 
the  cases  in  which  you  perform  a  port  swap  or  enable 
extended-edge  PID  (PID  Format  2)  on  a  switch,  the  value  is 
equal  to  the  Area  field  displayed  by  the  switchShow 
command.  For  port  swap  operations,  the  value  is  equal  to  the 
Swport  field  displayed  by  the  portSwapShow  command.  See 
HP  StorageWorks  Fabric  OS  5.x  Fabric  Watch  administrator's 
guide  for  more  information  regarding  the  extended-edge  PID 
format. 

Cost  of  reaching  the  destination  domain. 

Maximum  number  of  hops  required  to  reach  the  destination 
domain. 

Indicates  if  route  is  dynamic  (D)  or  static  (S).  A  dynamic  route  is 
discovered  automatically  by  the  FSPF  path  selection  protocol.  A 
static  route  is  assigned  using  the  command  uRouteConf  ig. 

Domain  and  port  number  of  the  next  hop.  These  are  the  domain 
number  and  the  port  number  of  the  switch  to  which  Out  Port  is 
connected. 


The  information  provided  by  this  command  should  match  what  is  provided  by  portRouteShow  and 
topologyShow. 


Operands 


This  command  has  the  following  operands: 


slotnumber 


For  bladed  systems  only,  specify  the  slot  number  of  the  input 
port  whose  routes  are  displayed,  followed  by  a  slash  (/). 
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portnumber  Specify  a  port  number.  Valid  values  for  port  number  vary, 

depending  on  the  switch  type.  Use  switchShow  to  display  a 
list  of  valid  ports.  This  operand  is  optional;  if  omitted,  the 
command  displays  routing  information  for  all  input  ports  in  the 
switch. 

domainnumber  Displays  routing  information  for  the  specified  domain.  This 

operand  is  optional;  if  omitted,  the  routing  information  for  all 
domains  in  the  fabric  is  displayed. 

Examples 

To  display  the  routing  information  of  all  the  active  ports: 

switch : admin>  urouteshow 
Local  Domain  ID:  3 


In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

0                    1  11 

1000 

1 

D 

1 ,  0 

11                    2  0 

1500 

2 

D 

4,0 

4  0 

500 

1 

D 

4,0 

16                    1  27 

1000 

1 

D 

1,1 

27                    2  16 

1500 

2 

D 

4, 16 

4  0 

500 

1 

D 

4,0 

To  display  the  routing  information  of  port  1  1 

on  slot  1 : 

switch : admin>  urouteshow  1/11 

Local  Domain  ID:  3 

In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

11                    2  16 

1500 

2 

D 

4,  16 

4  16 

500 

1 

D 

4,  16 

To  display  the  routing  information  of  port  1 1  to  domain 

4  only: 

switch : admin>  urouteshow  1/11, 

4 

Local  Domain  ID:  3 

In  Port        Domain        Out  Port 

Metric 

Hops 

Flags 

Next  (Dom, 

Port) 

11                    4  16 

500 

1 

D 

4, 16 

See  also 

portRouteShow 
topologyShow 
uRouteConf ig 
uRouteRemove 
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userConfig 

Manages  user  accounts. 

Synopsis 

userconfig   [actions]  [arguments] 

Availability 

all  users 

Description 

Use  this  command  to  display,  add,  delete,  change,  or  recover  switch  accounts.  You  can  create  new  login 
accounts  to  manage  a  switch.  These  accounts  take  on  the  permission  or  role  of  the  default  admin  or  user 
account.  When  the  command  completes,  account  name  and  other  attributes  are  saved  persistently.  In  a 
platform  supporting  multiple  domains,  the  affected  accounts  apply  only  to  the  switch  domain  that  the 
command  was  executed. 

In  secure  mode,  the  actions  associated  with  this  command  to  add,  delete,  change  or  recover  accounts 
are  allowed  only  on  the  primary  FCS  switch.  The  primary  FCS  switch  distributes  the  update  to  the  entire 
fabric.  As  a  result,  all  switches  supporting  customer-defined  accounts  will  have  the  same  account 
database.  All  accounts  that  not  consistent  with  the  primary  FCS  switch  will  be  deleted  and  saved  in  the 
backup  database.  Administrators  can  use  the  --recover  action  to  restore  the  accounts. 

Operands 

Without  any  specified  action,  the  command  prints  out  the  usage.  The  operands  are  as  follows: 

--show  options  Displays  current  or  backup  account  information. 

--add  username  Add  a  new  account  username  to  switch. 

[ options] 

--delete  username  Delete  an  account  username  from  the  switch. 

--change  username  Change  attributes  for  an  account  username. 

[ options] 

--recover  Recover  one  or  more  accounts  from  backup  created  by  Secure 

Fabric  OS  operations. 


NOTE:  The  --show  action  is  the  only  one  available  to  accounts  with  user  permission.  All  other  actions 
require  the  admin  permission. 
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The  following  sections  describe  of  each  action  type. 


--show  username   |    [-a  -b] 

Displays  information  about  the  current  login  account,  account 
named  username  or  all  accounts  either  in  active  or  backup 
account  database. 

If  running  from  an  account  with  user  permission,  the  command  can 
only  display  information  about  that  account.  The  following  table 
lists  the  result  of  different  combination  of  options. 


username 

-a 

-b 

Accounts 
displayed 

No 

No 

No 

Current  login 

Yes 

No 

No 

username 

No 

Yes 

No 

All  accounts 

Yes 

Yes 

No 

Not  valid 

No 

No 

Yes 

All  backup 
accounts 

Yes 

Yes 

Yes 

Not  valid 

--add  username  -r  rolename  -d  description 

Add  a  new  account  named  username  to  the  switch,  with  the  given 
authorization  of  rolename.  The  -d  option  gives  a  text  description 
for  the  new  account.  This  command  also  prompts  for  an  initial 
password. 

The  following  rules  apply  to  add  a  new  account: 

1.  username  must  be  unique  and  is  case  sensitive. 

2.  username  must  begin  with  a  letter  and  contain  only  letters, 
numbers  and  underscore. 

3.  The  maximum  length  of  username  is  40  characters. 

4.  description  is  optional.  The  maximum  length  is  40  printable 
ASCII  characters. 

5.  rolename  must  be  either  user  or  admin  in  nonsecure  mode;  it 
must  be  user,  admin,  or  nonf  csadmin  in  secure  mode. 

6.  There  can  be  maximum  1 5  customer  created  accounts  for  a 
switch. 

-delete  username  Delete  an  existing  account  named  username  from  the  switch.  This 

action  does  not  take  any  options.  It  prompts  for  confirmation  before 
proceeding.  After  an  account  is  deleted,  the  CLI  sessions 
associated  with  the  account  are  terminated.  The  following  rules 
apply  to  delete  an  account: 

1 .  You  cannot  delete  any  default  accounts. 

2.  An  account  cannot  delete  itself. 
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--change  username   [-r  rolename]    [-d  description]    [-e  yes    |  no] 

Change  attributes  for  an  existing  account,  named  username,  in 
the  switch.  The  -r  option  specifies  change  to  authorization 
rolename.  The  -d  option  specifies  change  to  description.  The  -e 
option  expects  either  yes  or  no  to  enable  or  disable  an  account. 
Once  an  account  is  disabled,  the  CLI  sessions  associated  with  the 
account  are  terminated.  The  following  rules  apply  to  change  an 
account: 

1 .  You  cannot  change  the  rolename  or  description  of  any 
default  accounts. 

2.  You  cannot  change  the  rolename  or  description  for 
accounts  at  the  same  or  higher  authorization  level. 

3.  An  account  cannot  change  the  rolename  of  itself. 

4.  Except  for  the  default  root  account,  no  account  can  disable 
itself. 

-recover  Recover  all  accounts  from  backup  database.  The  backup  database 

is  created  in  Secure  Fabric  OS,  when  certain  operations  cause  a 
switch  to  delete  some  of  its  customer  created  accounts.  For  details, 
read  the  secure  mode  description.  Once  accounts  have  been 
recovered,  the  accounts  in  the  backup  database  are  still  present. 

Examples 

To  add  a  new  account: 

switch : admin>  userconfig  --add  joan  -r  admin  -d  "joan  hoy" 

Setting  initial  password  for  joan 
Enter  new  password: 
Re-type  new  password: 

Account  joan  has  been  successfully  added. 
To  display  current  account  information: 


switch : admin>  userconfig  --show  joan 

Account  name:  joan 
Role:  admin 
Description:   Joan  Hoy 
Enabled:  Yes 

To  change  account  attributes: 

switch :  admin>  user-rename  USERID  admin 

See  also 

none 
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user  Rename 


Renames  the  user  login  name. 

Synopsis 


userrename  old  username  new  username 


Availability 

admin 


"2^f  NOTE:   This  command  is  not  supported  on  all  platforms. 


Description 

Use  this  command  to  change  an  existing  account  login  name  to  a  new  login  name.  The  following  rules 
apply: 

new_username  must  begin  with  a  letter  and  contain  only  alphanumeric  characters  or  underscores. 
new_username  must  be  between  1  and  40  characters  long. 
new_username  must  be  different  from  any  existing  account  login  name. 

If  old_username  is  a  default  login  name,  new_username  cannot  be  another  default  login  name. 

If  new_username  is  a  default  login  name,  it  must  indicate  the  same  role  as  old_username. 

When  using  HP  Secure  Fabric  OS,  rename  the  admin-level  login  name  to  the  HP-specific  default  of  admin 
and  the  user-level  login  name  to  the  HP-specific  default  of  user  before  enabling  security;  otherwise,  the 
switch  is  not  allowed  in  the  secure  fabric. 


Operands 


old_username  The  current  user  login  name 

new_username  The  new  user  login  name 


NOTE:   These  operands  are  case  sensitive. 

Examples 

To  rename  the  admin-level  login  name  from  "USERID"  to  "admin": 

switch : admin>  userrename  USERID  admin 

See  also 

secMode Enable 
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version 

Displays  firmware  version  information. 

Synopsis 

version 

Availability 

all  users 

Description 

Use  this  command  to  display  firmware  version  information  and  build  dates. 
The  following  information  appears: 


Kernel  Displays  the  version  of  switch  kernel  operating  system 

Fabric  OS  Displays  the  version  of  switch  Fabric  OS 

Made  on  Displays  the  build  date  of  firmware  running  in  switch 

Flash  Displays  the  build  date  of  firmware  stored  in  flash  proms 

BootProm  Displays  the  version  of  the  firmware  stored  in  the  boot  PROM 


Usually  the  Made  on  and  Flash  dates  are  the  same,  because  the  switch  starts  running  flash  firmware  at 
power-on.  However,  in  the  time  period  between  f  irmwareDownload  and  the  next  reboot,  the  dates 
can  differ. 

Operands 

none 

Examples 

To  display  the  firmware  version  information  in  a  switch: 


switch : admin>  version 

Kernel : 

2 . 4 . 19 

Fabric  OS: 

v4  .  4  .  0 

Made  on : 

Mon  Oct  4 

09 

27 

16 

2004 

Flash: 

Tue  Oct  5 

12 

13 

47 

2004 

BootProm: 

3 .1.18 

See  also 

f irmwareDownload 
reboot 
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voltShow 


Displays  the  current  level  of  the  voltage  sensors  on  a  system. 


Synopsis 


voltshow 


Availability 

admin 

Description 

Use  this  command  to  display  information  about  a  switch's  voltage  levels.  The  format  of  the  display  varies 
according  to  the  switch  model,  the  number  of  voltages  on  the  device,  and  the  number  of  voltage  sensors 
present. 

This  command  displays  the  following  fields: 


FRU  Type 

Number 
Voltage  levels 


One  of  the  following  values:  CHASSIS,  FAN,  I2C,  Control, 
CFlash,  SW  BLADE  (switch),  CP  BLADE  (control  processor),  or 
UNKNOWN. 

Slot  or  unit  number,  if  applicable. 

The  measured  voltage  for  these  designated  voltage  levels:  1 .2 
or  1 .8  volts  (depending  on  the  ASIC  type),  2.5  volts,  3.3  volts, 
5  volts,  1 2  volts,  48  volts,  and  53  volts. 

If  a  voltage  level  is  above  its  programmed  maximum,  it  has  a 
"+"  appended;  if  it  is  below  its  programmed  minimum,  a  "-"  is 
appended.  Nonapplicable  voltage  levels  are  displayed  as 


Operands 


none 
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Examples 

To  display  the  voltage  levels  on  a  system: 

switch: admin>  voltshow 

FRU  TYPE  -  Number  1.8/1.2V  2.5V     3.3V     5V         12V         48V  53V 


SW  BLADE  Slot:  2  1.82  2.51  3.30       --  11.94 

SW  BLADE  Slot:  3  0.00  0.00  0.09       --  12.31 

CP  BLADE  Slot:  5  --  2 . 48  3 . 29     5 . 17  12 . 50 

CP  BLADE  Slot:  6  --  2 . 50  3 . 29     5 . 17  12 . 50 

SW  BLADE  Slot:  8  1.80  2.52  3.30       --  12.00 

SW  BLADE  Slot:  9  1.80  2.51  3.97+     --  11.94 

SW  BLADE  Slot:  10  1.82  2.52  3.29       --  11.94 

FAN  Unit:    1  -  -  --         47.49  52.50 

FAN  Unit:   2  --  —  —         —  —         47.49  52.23 

FAN  Unit:   3  —  —  —         —  —         45.50-  52.23 

Sensor  Status:  +  =  above  max,    -  =  below  min. 


See  also 

sensorShow 
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wwn 


Displays  a  switch  world  wide  name  (WWN). 

Synopsis 

wwn 

Availability 

all  users 

Description 

Use  this  command  to  display  the  WWN  of  a  switch.  All  switches  have  a  numeric  address  that  is  the 
unique  Fibre  Channel  address  used  for  communicating  with  the  switch.  The  WWN  appears  in  the  output 

of  the  switchShow  command. 


f2^f  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

none 

Examples 

To  display  the  switch  WWN: 

switch : admin>  wwn 
10:00:00:60:69:00:54:e9 

See  also 

switchShow 
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zoneAdd 

Adds  a  member  to  the  zone. 

Synopsis 

zoneadd  "zoneName",   "member ; member" 

Availability 

admin 


122)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  add  one  or  more  members  to  an  existing  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

The  following  operands  are  required: 

zoneName  Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 

operand  is  required. 

member  Specify  a  member  or  list  of  members  to  be  added,  in  quotation 

marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  following: 

A  switch  domain  and  port  area  number  pair;  for  example,  2,  20. 
View  the  area  numbers  for  ports  using  the  switchShow  command. 

Node  or  port  WWN. 
QuickLoop  AL  PA. 
Zone  alias  name. 

Examples 

To  add  aliases  for  three  disk  arrays  to  Blue_zone: 

switch : admin>  zoneadd  "Blue_Zone",    "array3;   array4;  array5" 

See  also 

zoneCreate 
zoneDelete 
zoneRemove 
zoneShow 
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zoneCreate 


Creates  a  zone. 

Synopsis 

zonecreate  "zonename",   " member ; member" 

Availability 

admin 


r2^f  NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
b— I    Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  create  a  new  zone. 

A  zone  name  is  a  C-style  name  beginning  with  a  letter  and  followed  by  any  number  of  letters,  digits,  and 
underscore  characters.  Names  are  case  sensitive;  for  example,  Zone_l  indicates  a  different  zone  than 
zone_l.  Spaces  are  ignored.  Zone  names  are  limited  to  64  characters. 

The  zone  member  list  must  have  at  least  one  member.  The  members  are  described  by  a  list  of  member 
definitions,  separated  by  semicolons. 

Specify  ports  by  domain  and  port  area  number.  The  values  are  entered  as  a  pair  of  numbers  s ,  p.  The  s 
is  the  switch  number  (domain  ID)  and  p  is  the  port  area  number.  For  example, 

2 ,  2  0  specifies  port  area  number  20  on  switch  domain  2.  When  a  zone  member  is  specified  by  port 
area  number,  all  devices  connected  to  that  port  are  in  the  zone.  If  this  port  is  an  arbitrated  loop,  all 
devices  on  the  loop  are  in  the  zone. 

Specify  a  world  wide  name  as  eight  hex  numbers  separated  by  colons:  for  example, 
10:00:00:60:69:00:00:  8a.  Zoning  compares  the  WWN  with  the  node  and  port  names  presented 
by  a  device  in  a  login  frame  (FLOGI  or  PLOGI).  When  a  zone  member  is  specified  by  node  name,  then 
all  ports  on  that  device  are  in  the  zone.  When  a  zone  member  is  specified  by  port  name,  then  only  that 
single  device  port  is  in  the  zone. 

Specify  a  QuickLoop  AL  PA  as  a  QuickLoop  name  followed  by  a  list  of  AL  PAs:  for  example, 
qloopl  [01,02].  QuickLoop  names  have  the  same  format  as  zone  names  and  are  created  with  the 
qloopCreate  command  to  define  a  switch  or  pair  of  switches  that  form  the  QuickLoop. 

Specify  a  zone  alias  name  using  the  same  format  as  a  zone  name.  A  zone  alias  is  created  with  the 
aliCreate  command.  The  alias  must  resolve  to  a  list  of  one  or  more  of  the  following: 

•  A  switch  domain  and  port  area  number  pair.  View  the  area  numbers  for  ports  using  the  switchShow 
command. 

•  world  wide  names. 

•  QuickLoop  AL_PAs. 

The  types  of  zone  members  used  to  define  a  zone  can  be  mixed.  For  example,  a  zone  defined  with  the 
members  2, 12;  2,14;   10:00:00:60:69:00:00:  8a  would  contain  all  devices  connected  to  switch 
2,  ports  1  2  and  14,  and  to  the  device  with  the  world  wide  name  10:00:00:60:69:00:00:  8a  (either 
node  name  or  port  name),  at  the  port  in  the  fabric  to  which  it  is  connected. 
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This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    Use  this  command  to  create  a  broadcast  zone.  This  is  a  special  zone  used  to  specify  those  nodes 
that  can  receive  broadcast  traffic.  Broadcast  traffic  is  usually  meant  for  servers  and  not  for  storage 
devices.  This  zone  must  be  named  broadcast.  Only  one  broadcast  zone  can  exist  within  a  fabric.  This 
type  of  zone  is  hardware  enforced;  the  switch  controls  data  transfer  to  a  port. 
When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

The  following  operands  are  required: 

zonename  Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 

operand  is  required. 

member  Specify  a  member  or  list  of  members  to  be  added,  in  quotation 

marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  following: 

•  A  switch  domain  and  port  area  number  pair;  for  example,  2, 
20.  View  the  area  numbers  for  ports  using  the  switchShow 
command. 

•  Node  or  port  WWN. 

•  QuickLoop  AL  PA. 

•  Zone  alias  name. 

Examples 

To  create  three  zones  using  a  combination  of  port  numbers  and  zone  aliases: 


switch; 

: admin> 

zonecreate 

"Red_zone" , 

"1,0; 

loopl " 

switch; 

: admin> 

zonecreate 

"Blue_zone " , 

"1,1; 

arrayl ; 

1,2; 

array2 " 

switch; 

: admin> 

zonecreate 

"Green_zone " 

,  "1,0 

;  loopl; 

1,2; 

array2 " 

See  also 

zone Add 
zoneDelete 
zoneRemove 
zoneShow 
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zoneDelete 


Deletes  a  zone. 


Synopsis 


zonedelete  "zonename 


Availability 


admin 


r2^>  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 


Use  this  command  to  delete  a  zone. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 


NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Description 


Operands 


This  command  has  the  following  operand: 

zonename       Name  of  the  zone  to  be  deleted,  in  quotation  marks.  This  operand  is 
required. 


Examples 


To  delete  the  zone  Blue  zone: 


switch : admin>  zonedelete  "Blue_zone 


See  also 


zone Add 


zoneCreate 


zoneRemove 


zoneShow 
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zoneHelp 

Displays  help  information  for  zone  commands. 

Synopsis 

zonehelp 

Availability 

all  users 

Description 

Use  this  command  to  display  help  information  for  zone  commands. 

Operands 

none 

Examples 

To  display  zone  command  help  information: 


See  also 


switch : admin>  zonehelp 

aliAdd 

aliCreate 

aliDelete 

aliRemove 

aliShow 

Add  a  member  to  a  zone  alias 

Create  a  zone  alias 

Delete  a  zone  alias 

Remove  a  member  from  a  zone  alias 

Print  zone  alias  information 

f azoneAdd 
f azoneCreate 
f azoneDelete 
f a zone Show 

Add  a  member  to  a  fabric  assist  zone 
Create  a  fabric  assist  zone 
Delete  a  fabric  assist  zone 
Print  Fabric  Assist  Zone  information 

cf gClear 

cf gDisable 

cf gEnable 

cf gSize 

c  f gTransAbor t 

Clear  all  zone  configurations 
Disable  a  zone  configuration 
Enable  a  zone  configuration 
Print  size  details  of  zone  database 
Abort  zone  configuration  transaction 

aliAdd 

aliCreate 

aliasDelete 

aliRemove 

aliShow 

cf gClear 
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cf gDisable 
cf gEnable 
cf gSize 
cf gTransAbort 
f aZoneAdd 
f aZoneCreate 
f aZoneDelete 
f aZoneShow 
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zoneObjectCopy 

Copies  a  zone  object. 

Synopsis 

zoneObjectCopy  " obj ectName"  ,  "newName" 

Availability 

admin 


\^)f  NOTE:  This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
b— I    Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  copy  a  zone  object  to  a  new  zone  object.  The  resulting  object  has  the  same  type  as 
the  original  object.  You  can  use  this  command  for  all  zone  object  types,  including  cfg,  zone,  and  alias. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive;  for  example,  cf g_l  and  cfg_l  are  different  zone 
configurations.  Spaces  are  ignored. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

See  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 


'^f  NOTE:   When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 

This  command  has  the  following  operands: 

objectName  The  name  of  the  object  that  you  want  to  copy.  This  operand  is  required. 

newName  The  name  of  the  object  that  you  want  created.  This  operand  is  required. 

Examples 

To  create  a  configuration  containing  three  zones: 


switch : admin>  cfgShow  "*" 

cfg:       USA_cfg        Red_zone;  White_ 

.zone , 

Blue_ 

.zone 

switch: admin>  zoneObjectCopy  "USA_cfg", 

"UK_ 

_cfg" 

switch : admin>  cfgShow  "*" 

cfg:       UK_cfg          Red_zone;  White_ 

.zone , 

Blue_ 

.zone 

cfg:       USA_cfg        Red_zone;  White_ 

.zone , 

Blue. 

.zone 
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See  also 

cfgAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 

zoneObj  ectRename 
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zoneObjectExpunge 


Expunges  a  zone  object. 

Synopsis 

zoneObj  ectExpunge  " obj ectName" 

Availability 

admin 


122)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  expunge  a  zone  object.  In  addition,  to  performing  a  simple  delete,  this  command 
also  removes  the  object  from  the  member  lists  of  all  other  objects.  Afterwards,  this  object  is  completely 
removed  from  the  database.  You  can  use  this  command  for  all  zone  object  types,  including  cfg,  zone, 
and  alias. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

j^frf  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

This  command  has  the  following  operand: 

objectName  The  name  of  the  object  that  you  want  to  expunge.  This  operand  is  required. 
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Examples 

To  create  a  configuration  containing  three  zones: 


switch : admin>  cfgShow 

Defined 

configuration : 

cfg: 

USA_cfg        Red_zone;  White_zone; 

Blue_ 

zone 

zone : 

Blue_zone 

1,1;   arrayl ;   1,2;  array2 

zone : 

Red_zone 
1,0;  loopl 

zone : 

White_zone 
1,3;  1,4 

alias : 

arrayl     21 : 00 : 00 : 2 0 : 37 : 0c : 76 : 8c ; 

21 

00 

:00: 

20 

37 

0c 

71 

02 

alias : 

array2     21 : 00 : 00 : 20 : 37  :  0c  :  76  :  22  ; 

21 

00 

:00: 

20 

37 

0c 

76 

28 

alias : 

loopl  21:00:00:20:37:0c:76:85; 

21 

00 

:00: 

20 

37 

0c 

71 

df 

switch : admin>  zoneObj ectExpunge  "White_zone" 

switch : admin>  cfgShow 

Defined 

configuration : 

cfg: 

USA_cfg        Red_zone;  Blue_zone 

zone : 

Blue_zone 

1,1;   arrayl ;   1,2;  array2 

zone : 

Red_zone 
1,0;  loopl 

alias : 

arrayl     21 : 00 : 00 : 2 0 : 37 : 0c : 76 : 8c ; 

21 

00 

:00: 

20 

37 

0c 

71 

02 

alias : 

array2     21 : 00 : 00 : 20 : 37 : 0c : 76  :  22  ; 

21 

00 

:00: 

20 

37 

0c 

76 

28 

alias : 

loopl  21:00:00:20:37:0c:76:85; 

21 

00 

:00: 

20 

37 

0c 

71 

df 

See  also 

cfgAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cfgShow 

zoneObj  ectCopy 
zoneObj  ectRename 
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zoneObjectRename 


Renames  a  zone  object. 

Synopsis 

zoneObjectRename  " obj ectName"  ,  "newName" 

Availability 

admin 


122)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 

Use  this  command  to  rename  a  zone  object.  You  can  use  this  command  for  all  zone  object  types, 
including  cfg,  zone,  and  alias. 

A  zone  configuration  name  must  begin  with  a  letter  that  can  be  followed  by  any  number  of  letters, 
numbers,  and  underscores.  Names  are  case  sensitive;  for  example,  cf g_l  and  cfg_l  are  different  zone 
configurations.  Spaces  are  ignored. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cf  gSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

See  the  zoneCreate  command  for  more  information  on  name  and  member  specifications. 


jj^j?  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 

Operands 

This  command  has  the  following  operands: 

objectName  The  name  of  the  object  that  you  want  to  rename.  This  operand  is  required. 

newName  The  new  name  of  the  object.  This  operand  is  required. 

Examples 

To  create  a  configuration  containing  three  zones: 


switch : admin>  cfgShow  "*" 

cfg:       USA_cfg  Red_zone 

White_zone;  Blue_zone 

switch : admin>  zoneObjectRename 

USA_cfg",  "UK_cfg" 

switch : admin>  cfgShow  "*" 

cfg:       UK_cfg  Red_zone 

White_zone;  Blue_zone 
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See  also 

cfgAdd 
cf gClear 
cf gDelete 
cf gDisable 
cf gEnable 
cf gRemove 
cf gSave 
cf gShow 

zoneObj  ectCopy 
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zoneRemove 


Removes  a  member  from  a  zone. 


Synopsis 


zoneremove    zonename  ,     member ; member 


Availability 

admin 


122)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 
Configuration  Services  and  bundled  with  each  B-series  switch. 


Description 


Use  this  command  to  remove  one  or  more  members  from  an  existing  zone. 

The  member  list  is  located  by  an  exact  string  match;  therefore,  it  is  important  to  maintain  the  order  when 
removing  multiple  members.  For  example,  if  a  zone  contains  array2  ;  array3  ;  array4,  removing 
array3  ;   array4  succeeds  but  removing  array4  ;   array3  fails. 

If  all  members  are  removed,  the  zone  is  deleted. 

This  command  changes  the  defined  configuration.  For  the  change  to  be  preserved  across  switch  reboots, 
it  must  be  saved  to  flash  memory  using  the  cfgSave  command.  For  the  change  to  become  effective,  an 
appropriate  zone  configuration  must  be  enabled  using  the  cfgEnable  command. 

jj^j?  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Operands 


The  following  operands  are  required: 

zoneName 


member 


Specify  the  name  of  an  existing  zone,  in  quotation  marks.  This 
operand  is  required. 

Specify  a  member  or  list  of  members  to  be  added,  in  quotation 
marks,  separated  by  semicolons.  Valid  values  can  be  one  or  more  of 
the  following: 

•  A  switch  domain  and  port  area  number  pair;  for  example,  2, 
20.  View  the  area  numbers  for  ports  using  the  switchShow 
command. 

•  Node  or  port  WWN. 

•  QuickLoop  AL  PA. 

•  Zone  alias  name. 
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Examples 

To  remove  array2  from  Blue_zone: 


switch; 

:admin>  zoneremove 

"Blue_zone" , 

" array2 " 

switch: 

:admin>  zoneremove 

"Blue_zone" , 

"2,20" 

See  also 

zone Add 
zoneCreate 
zoneDelete 
zoneShow 
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zoneShow 


Displays  zone  information. 


Synopsis 


zoneshow   ["pattern"]  [,  mode] 


Availability 


all  users 


\^)f  NOTE:   This  command  requires  HP  Advanced  Zoning  license,  which  is  included  within  the  Base 


If  no  parameters  are  specified,  all  zone  configuration  information  (both  defined  and  enabled)  is 
displayed.  See  cf  gShow  for  a  description  of  this  display. 

If  a  parameter  is  specified,  it  is  used  as  a  pattern  to  match  zone  configuration  names,  and  those  that 
match  in  the  defined  configuration  are  displayed. 


\^)f  NOTE:    When  security  mode  is  enabled,  this  command  can  be  issued  only  from  the  primary  FCS  switch. 


Description 


Use  this  command  to  display  zone  configuration  information. 


Operands 


The  following  operand  is  optional: 


pattern 


A  POSIX-style  regular  expression  used  to  match  zone  configuration  names.  The 
pattern  must  be  enclosed  in  quotation  marks.  Patterns  can  contain: 


A  question  mark  (?),  which  matches  any  single  character. 


An  asterisk  (*),  which  matches  any  string  of  characters. 


mode 


Ranges,  which  match  any  character  within  the  range:  for  example,  [0-9]  or  [a-f]. 

Specify  0  to  display  the  contents  of  the  transaction  buffer  (the  contents  of  the 
current  transaction),  or  specify  1  to  display  the  contents  of  the  flash  memory.  The 
default  value  is  0.  This  operand  is  optional. 


Examples 


To  display  all  zones  beginning  with  the  letters  A  through  C: 


switch : admin>  zoneshow  " [A-C] * 


zone:   Blue_zone  1,1;   arrayl ;   1,2;  array2 
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See  also 

zone Add 
zoneCreate 
zoneDelete 
zoneRemove 
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3    Licensed  product  commands 


This  chapter  summarizes  the  commands  that  are  available  only  with  a  license  key. 

•  Advanced  zoning  commands,  page  767 

•  QuickLoop  Fabric  Assist  mode  commands,  page  768 

•  Extended  Fabrics  command,  page  769 

•  Fabric  Watch  commands,  page  769 

•  ISL  Trunking  commands,  page  769 

•  Advanced  Performance  Monitoring  commands,  page  770 

•  Secure  Fabric  OS  commands,  page  771 

NOTE:  For  more  information  about  Advanced  Zoning,  QuickLoop,  Extended  Fabrics,  Fabric  Watch, 
Trunking,  or  Performance  Monitoring,  see  the  HP  StorageWorks  Fabric  OS  5.x  features  overview. 


Advanced  zoning  commands 

The  commands  listed  in  Table  20  are  available  with  the  purchase  of  an  HP  Advanced  Zoning  license  key. 
Table  20   Zoning  commands 


Command 

Description 

Zone  Alias 

aliAdd 

Adds  a  member  to  a  zone  alias. 

aliCreate 

Creates  a  zone  alias. 

aliDelete 

Deletes  a  zone  alias. 

aliRemove 

Removes  a  member  from  a  zone  alias. 

Zoning 

zoneAdd 

Adds  a  member  to  a  zone. 

zoneCreate 

Creates  a  zone. 

zoneDelete 

Deletes  a  zone. 

zoneRemove 

Removes  a  member  from  a  zone. 

Zone  Configuration 

cfgAdd 

Adds  a  zone  to  a  zone  configuration. 
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Table  20   Zoning  commands  (continued) 


Command 

Description 

cf gCreate 

Creates  a  zone  configuration. 

cf gDelete 

Deletes  a  zone  configuration. 

cf gRemove 

Removes  a  zone  from  a  zone  configuration. 

Zone  Management 

cf gClear 

Clears  all  zone  configurations. 

cfgDisable 

Disables  a  zone  configuration. 

cf gEnable 

Enables  a  zone  configuration. 

cf gSave 

Saves  zone  configurations  in  flash  memory. 

cf gTransAbort 

Aborts  the  current  zoning  transaction. 

zoneObj  ectCopy 

Copies  a  zone  object. 

zoneObj  ectExpunge 

Expunges  a  zone  object. 

zoneObj  ectRename 

Renames  a  zone  object. 

QuickLoop  Fabric  Assist  mode  commands 

The  commands  listed  in  Table  21  are  for  QuickLoop  Fabric  Assist  mode. 
Table  21    QuickLoop  fabric  assist  mode  commands 


Command 

Description 

f aZoneAdd 

Adds  members  to  an  existing  QuickLoop  Fabric  Assist  zone. 

f aZoneCreate 

Creates  a  QuickLoop  Fabric  Assist  zone. 

f aZoneDelete 

Deletes  an  existing  QuickLoop  Fabric  Assist  zone. 

f aZoneRemove 

Removes  members  from  an  existing  QuickLoop  Fabric  Assist  zone. 

qloopAdd 

Adds  a  member  to  a  QuickLoop. 

qloopCreate 

Creates  a  QuickLoop. 

qloopDelete 

Deletes  a  QuickLoop. 

qloopRemove 

Removes  a  member  from  a  QuickLoop. 

qloopShow 

Displays  QuickLoop  information. 

NOTE:    The  QuickLoop  Fabric  Assist  mode  is  not  available  on  Fabric  OS  5.x. 
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Extended  Fabrics  command 

The  command  described  in  Table  22,  is  available  with  the  purchase  of  an  HP  Extended  Fabrics  license 
key. 

Table  22    Extended  fabrics  commands 


Command 

Description 

portCfgLongDistan.ee 

Configure  a  port  to  support  long-distance  links. 

Fabric  Watch  commands 

The  commands  listed  in  Table  23  are  available  with  the  purchase  of  an  HP  Fabric  Watch  license  key. 
Table  23    Fabric  watch  commands 


Command 

Description 

fwClassInit 

Initialize  all  classes  under  Fabric  Watch. 

fwConf igReload 

Reload  the  Fabric  Watch  configuration. 

fwConf igure 

Display  and  enable  modification  of  the  Fabric  Watch 
configuration  and  status. 

fwShow 

Display  the  thresholds  monitored  by  Fabric  Watch. 

fwAlarmsFi Iter Set 

Enable  or  disable  alarms  for  Fabric  Watch. 

fwAlarmsFi Iter Show 

Display  alarm  filtering  for  Fabric  Watch. 

fwFruCf g 

Display  and  changes  FRU  state  alert  configuration. 

fwMailCfg 

Configure  e-mail  alerts  in  Fabric  Watch. 

fwSetToDefault 

Set  boundary  and  alarm  levels  to  the  default  values. 

fwSetToCustom 

Set  boundary  and  alarm  levels  to  custom  values. 

ISL  Trunking  commands 

The  commands  listed  in  Table  24  are  available  with  the  purchase  of  an  HP  Trunking  license  key.  For 
more  detailed  information  about  trunking,  see  the  HP  StorageWorks  Fabric  OS  5.x  procedures  user 
guide. 

Table  24    HP  trunking  commands 


Command 

Description 

portCf gTrunkPort 

Configure  a  port  for  trunking. 

switchCf gTrunk 

Configure  a  switch  for  trunking. 

trunkDebug 

Debug  a  trunk  link  failure. 
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Advanced  Performance  Monitoring  commands 

The  commands  listed  in  Table  25  are  available  with  the  purchase  of  an  HP  Advanced  Performance 
Monitoring  license  key. 

Table  25    Performance  monitoring  commands 


Command 

Description 

perf AddEEMonitor 

Add  an  end-to-end  monitor  to  a  port. 

perf AddlPMonitor 

Add  an  IP  monitor  to  a  port. 

perf AddReadMoni tor 

Add  a  SCSI  Read  monitor  to  a  port. 

perf AddRWMoni tor 

Add  a  SCSI  Read  and  Write  monitor  to  a  port. 

perfAddSCSIMonitor 

Add  a  SCSI  traffic  frame  monitor  to  a  port. 

perf AddUserMoni tor 

Add  a  user-defined  monitor  to  a  port. 

per f AddWriteMonitor 

Add  a  SCSI  Write  monitor  to  a  port. 

perf Cf gClear 

Clear  the  performance  monitoring  settings  from  flash  memory. 

perf Cf gRes tore 

Restore  performance  monitoring  settings  from  flash  memory. 

perf Cf gSave 

Save  the  current  performance  monitoring  settings  to  flash  memory. 

perf ClearEEMoni tor 

Clear  statistics  counters  of  an  end-to-end  (EE)  monitor  on  a  port. 

perf ClearFilterMoni tor 

Clear  statistics  counters  of  a  filter-based  monitor. 

perf ClrAlpaCrc 

Clear  an  AL_PA  device  CRC  count  by  the  port  and  AL_PA. 

perf DelEEMoni tor 

Delete  an  end-to-end  monitor  on  port. 

perf DelFilterMoni tor 

Delete  a  filter-based  monitor. 

perf Set PortEEMask 

Set  overall  mask  for  end-to-end  (EE)  monitors. 

perf ShowAlpaCrc 

Display  the  AL_PA  CRC  count  by  port  or  by  AL_PA. 

perf ShowEEMoni tor 

Display  user-defined  end-to-end  monitors  on  a  port. 

perf ShowFilterMonitor 

Display  filter-based  monitors  for  a  port. 

perf ShowPortEEMask 

Display  the  current  end-to-end  mask  of  a  port. 
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Secure  Fabric  OS  commands 

The  commands  listed  in  Table  26  are  available  with  the  purchase  of  an  HP  Security  license  key.  For  more 
detailed  information  about  security,  see  the  HP  StorageWorks  Secure  Fabric  OS  user  guide.) 

Table  26    HP  secure  fabric  OS  commands 


Command 

Description 

secFabricShow 

Displays  security  related  fabric  information. 

secFCSFai lover 

Enables  a  backup  FCS  switch  to  take  over  as  primary  FCS  switch. 

secHelp 

Display  information  about  security  telnet  commands. 

rnnh  o  co/~i  iritv/  m Anfl 
LMUUlo  boL.UMIy  IllUUt. 

Il  i  c /*i  n  1  o  co/~i  i  n  tv/  rnAno 
L/lbUUIt:  c>fc2(_Ullly  IIHJUfci. 

Ilicnl/"i\/  it  co^"i i  ci  tv/  m  aHq  ic  annn  on  r\  r  /-li  c/t  nlo/H 
L/lbUlvJy  II  bt2(_Ullly  IIKJvJti  lo  fcillvJUIfciU  (Jl  UloUUIcU. 

\nf  fho  nnmin         c c\A//~ir/H  f/~\r  nAn. r~C  c\A/if/*hoc 
Jtl    lilt?  UUIIlIM  UUbbWUlU   IUI    MUM  1  V-O  bWIILMob. 

S  GC  Po  1 1  cyAtoo  IT  t 

ZAn/""\i"tc  /ill  rnnnnoc  \r\  fno  r\ oti  n o/-l  r\ /~i t/-i h/^co  thnt  n/iv/o  n/~\t  noon 
nUUI  lb  UN  UlUllUtb  IU  lilt;  UcllMcU  UUIUUUbu  IIIUI  llUVfci  \\\J\  Uccl  1 

saved. 

secPolicyActivate 

Apply  defined  policy  set  to  all  switches  in  the  fabric. 

secPolicyAdd 

Add  members  to  an  existing  policy. 

secPolicyCreate 

Create  a  new  policy. 

cz"  a  i~<  O  f  \  1  i      t  tT~1      T  q  ^  a 
ofcrCiruJ-J-CyiJc-l-C=Lfc= 

1)0  oto  nn  ovictiriAi  t~\/~\\\f\i 
L^tMcMfc;  UN  cAlbMMU  UUMLy. 
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Ilicnl/"i\/  /ill  momnorc  r\T  o  vi  c  ti  n  /i  n/~i  inoc 
L-'IbUIUy  UN   lllfcMllUfcMb  Ul   CAlbllMU   UUI  ILItb. 

KA /~i\/o  /~i  mo m nor  in  tno  Fi  (™*/~\li/~\/ 
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s  ec  Po 1 i  cy Save 

s,  /-i\/o  d  /ioti  nod  co^"iintv/  nA          t/~\  tl/icn  mom/~\rv/  /~\n  /"ill  cu/itrnoc  in 
JUVt  U  UcllllcU  bcLUIIIy  pUIH_y  l(J  llvjoll  lllfcMIIUly  UM  UN  bWIIUlcb  III 

the  fabric. 

s  ec  Po 1 i  cyShow 

Display  an  existing  security  policy. 

secStatsReset 

Reset  security  statistic  for  a  policy  or  all  policies  to  0. 

secStatsShow 

Display  security  statistic  for  a  policy  or  for  all  policies. 

secTempPasswdReset 

Reset  a  password  on  a  remote  switch. 

secTempPasswdSet 

Set  a  temporary  password  on  a  remote  switch. 

secTransAbort 

Abort  current  security  transaction. 

secVersionReset 

Reset  the  version  stamp  to  0. 
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4    Exclusive  primary  FCS  commands 


This  chapter  summarizes  the  commands  that  are  available  on  the  primary  FCS  only  when  the  security 
feature  is  installed  and  enabled. 


Commands  exclusive  to  the  primary  FCS 

The  following  commands  are  available  on  the  primary  FCS  only  when  security  is  installed  and  enabled. 
Table  27    Commands  exclusive  to  the  primary  FCS 


Command 

Notes 

agtCfgSet 

Can  be  run  on  all  switches,  but  it  needs  to  be  run  on  the  primary  FCS  to  modify 
community  strings 

agtCf gDef ault 

Must  be  run  from  the  primary  FCS  switch. 

aliAdd 

Must  be  run  from  the  primary  FCS  switch. 

aliCreate 

Must  be  run  from  the  primary  FCS  switch. 

aliDelete 

Must  be  run  from  the  primary  FCS  switch. 

aliRemove 

Must  be  run  from  the  primary  FCS  switch. 

aliShow 

Must  be  run  from  the  primary  FCS  switch. 

cf gAdd 

Must  be  run  from  the  primary  FCS  switch. 

cf gClear 

Must  be  run  from  the  primary  FCS  switch. 

cf gCreate 

Must  be  run  from  the  primary  FCS  switch. 

cf gDelete 

Must  be  run  from  the  primary  FCS  switch. 

cf gDisable 

Must  be  run  from  the  primary  FCS  switch. 

cf gEnable 

Must  be  run  from  the  primary  FCS  switch. 

cf gRemove 

Must  be  run  from  the  primary  FCS  switch. 

cf gSave 

Must  be  run  from  the  primary  FCS  switch. 

cf gShow 

Can  be  run  on  all  FCS  switches. 

cf gTransAbort 

Must  be  run  from  the  primary  FCS  switch. 

cfgTransShow 

Must  be  run  from  the  primary  FCS  switch. 

date 

This  command  can  be  run  on  all  switches  to  view  the  current  date.  You  can 
only  modify  the  date  from  the  primary  FCS  switch. 
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Table  27    Commands  exclusive  to  the  primary  FCS  (continued) 


Command 

Notes 

f aZoneAdd 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneCreate 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneDelete 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneRemove 

Must  be  run  from  the  primary  FCS  switch. 

f aZoneShow 

Must  be  run  from  the  primary  FCS  switch. 

msConf igure 

Can  be  run  on  all  switches,  but  it  does  not  display  ACL  in  secure  mode. 

msPlMgmtDeactivate 

Must  be  run  from  the  primary  FCS  switch. 

ms PlMgmtAc t  ivat e 

Must  be  run  from  the  primary  FCS  switch. 

msPlClearDB 

Must  be  run  from  the  primary  FCS  switch. 

msTdDisable 

mstddisable  "ALL"  must  be  run  from  the  primary  FCS  switch. 

msTdEnable 

mstdenable  "ALL"  must  be  run  from  the  primary  FCS  switch. 

passwd 

Must  be  run  from  the  primary  FCS  switch. 

sec  Fabr  i  c  Show 

Must  be  run  from  the  primary  FCS  switch. 

secModeDi sable 

Must  be  run  from  the  primary  FCS  switch. 

secNonFcsPasswd 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyAbort 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyActivate 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyAdd 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyCreate 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyDelete 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyDump 

Can  be  run  on  all  FCS  switches. 

secPolicyFCSMove 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyRemove 

Must  be  run  from  the  primary  FCS  switch. 

secPolicySave 

Must  be  run  from  the  primary  FCS  switch. 

secPolicyShow 

Can  be  run  on  all  FCS  switches. 

secTempPasswdSet 

Must  be  run  from  the  primary  FCS  switch. 

secTempPasswdReset 

Must  be  run  from  the  primary  FCS  switch. 
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Table  27    Commands  exclusive  to  the  primary  FCS  (continued) 


^Ul  1 II 1 IUI IU 

secVersionReset 

Must  be  run  from  the  primary  FCS  switch.  Can  also  be  run  on  a  single 

MUM  1  V^J  bVVML.ll  WMIL.ll  lb  bcLJlllCMlloLl   IIUlll  LI  IL1UML. 

tsClockServer 

Can  be  run  on  all  switches  to  view  the  NTP  server's  IP  address.  You  can  only 
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enabled  the  WWN  of  a  switch  cannot  be  modified. 

zoneAdd 

Must  be  run  from  the  primary  FCS  switch. 

zoneCreate 

Must  be  run  from  the  primary  FCS  switch. 

zoneDelete 

Must  be  run  from  the  primary  FCS  switch. 

zoneRemove 

Must  be  run  from  the  primary  FCS  switch. 

zoneShow 

Must  be  run  from  the  primary  FCS  switch. 
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5    MUA-based  roles 


This  chapter  summarizes  the  commands  that  are  applicable  to  the  multiple  user  account  (MUA)  roles.  The 
MUA  feature  distinguishes  between  a  user  account  and  the  role  assigned  to  the  account.  This  chapter 
includes  information  for  the  switchAdmin  role. 


switchAdmin  Role  Permissions 

The  switchAdmin  role  offers  most  of  the  permissions  of  the  existing  admin  role,  except  the  ability  to 
configure  zones,  perform  security-related  functions,  and  perform  user  management.  Table  28  lists 
commands  available  to  the  switchAdmin  role. 

Table  28    switchAdmin  commands 


Command 

Description 

agtCfgDef ault 

Resets  the  SNMP  agent  configuration  to  default  values. 

agtCfgSet 

Modifies  the  SNMP  agent  configuration. 

agtCf gShow 

Displays  the  SNMP  agent  configuration. 

aliasDelete 

Deletes  a  port  from  all  local  groups. 

aliasJoin 

Creates  a  multicast  alias  group  of  N_Ports.  If  the  group  already  exists, 
the  N_Ports  are  added  to  the  existing  group. 

aliasPurge 

Removes  an  alias  group. 

aliasShow 

Displays  local  alias  server  information. 

aptPolicy 

Changes  or  displays  the  Advanced  Performance  Tuning  (APT)  policy. 

authutil 

Displays  and  sets  the  authentication  configuration. 

bannerSet 

Sets  the  banner  on  the  local  switch. 

bannerShow 

Displays  the  banner  text. 

bcastShow 

Displays  broadcast  routing  information. 

burninErrClear 

Clears  errors  stored  in  the  nonvolatile  storage  on  the  slot  during  burn-in. 

burninErrShow 

Displays  errors  stored  in  the  nonvolatile  storage  on  the  slot  during 
burn-in. 

burninLevel 

Sets  the  diagnostics  burn-in  level. 

burninStatus 

Displays  the  diagnostics  burn-in  level. 

chassisConf ig 

Displays  or  sets  the  configuration  of  the  chassis. 

chassisName 

Displays  or  sets  the  chassis  name  for  a  switch. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

chassisShow 

Displays  all  field  replaceable  units  (FRUs). 

chipRegShow 

Displays  the  port  registers  for  a  given  chip  number. 

cmemRe  t  en t  i  onTes t 

Tests  the  data  retention  of  the  central  memory  SRAMs. 

cmiTest 

Verifies  the  control  message  interface  (CMI)  bus  between  ASICs. 

conf igShow 

Displays  system  configuration  settings. 

conf igDownload 

Downloads  a  switch  configuration  file  from  a  host  file,  omitting  zoning 
and  security  configurations. 

conf igUpload 

Uploads  the  switch  configuration  file  to  a  host  file. 

configure 

Modifies  system  configuration  parameters. 

dataTypeShow 

Displays  sample  data  stream  types  used  in  some  diagnostic  commands. 

date 

Displays  or  sets  the  switch  date  and  time. 

dbgShow 

Displays  current  values  of  debug  and  verbosity  levels  of  the  specified 
module. 

diagHelp 

Displays  diagnostic  command  information. 

dlsReset 

Disables  the  dynamic  load  sharing  (DLS)  option. 

dlsSet 

Enables  the  dynamic  load  sharing  (DLS)  option. 

dlsShow 

Display  the  setting  of  the  dynamic  load  sharing  (DLS)  option. 

dnsConf ig 

Sets  or  displays  domain  name  service  (DNS)  parameters. 

enclosureShow 

Displays  attributes  of  the  switch  enclosure. 

errClear 

Clears  all  error  log  messages  for  all  switch  instances  on  this  control 
processor  (CP). 

errDelimiterSet 

Sets  the  error  log  start  and  end  delimiter  for  messages  sent  to  the 
console  and  syslog. 

errDump 

Displays  the  error  log,  without  pagination. 

errModuleShow 

Displays  all  the  defined  error  log  modules. 

errShow 

Displays  the  error  log  messages,  with  pagination. 

exit 

Logs  out  from  a  shell  session. 

f abPortShow 

Displays  fabric  port  information. 

f abRetryShow 

Displays  the  retry  count  of  the  fabric  commands. 

f abricLog 

Displays  or  manipulates  the  fabric  log. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

fabric Principal 

Sets  principal  switch  selection  mode. 

f abricShow 

Displays  fabric  membership  information. 

f abStateClear 

Clears  the  fabric  state  information. 

f abStateResize 

Changes  the  number  of  state  entries. 

f abStateShow 

Displays  the  fabric  state  information. 

f abStatsShow 

Displays  the  fabric  statistics. 

f abSwitchShow 

Displays  the  fabric  switch  state  structure  information. 

f anShow 

Displays  fan  status  and  speed. 

f astBoot 

Reboots  the  control  processor  (CP),  bypassing  power-on  self-test  (POST). 

f cPing 

Sends  a  Fibre  Channel  Extended  Link  Service  (ELS)  ECHO  request  to  a 
pair  of  ports. 

f cpLogClear 

Clears  the  FCPD  debug  information  log  (debug  command). 

f cpLogDi sable 

Disables  the  FCPD  debug  information  log  (debug  command). 

f cpLogEnable 

Enables  the  FCPD  debug  information  log  (debug  command). 

f cpLogShow 

Displays  the  FCPD  debug  information  log  (debug  command). 

f cpProbeShow 

Displays  the  Fibre  Channel  Protocol  (FCP)  probe  information. 

f cpRlsShow 

Display  the  Fibre  Channel  Protocol  (FCP)  Read  Link  Status  (RLS) 
information. 

f dmiCacheShow 

Displays  abbreviated  remote  FDMI  device  information,  according  to 
remote  domain  ID. 

f dmiShow 

Displays  detailed  FDMI  device  information. 

f iconClear 

Clears  the  records  from  the  specified  FICON  database. 

f iconcupset 

Sets  FICON-CUP  parameters  for  a  switch. 

f iconcupshow 

Displays  FICON-CUP  parameters  for  a  switch. 

f iconShow 

Displays  the  contents  of  the  specified  FICON  database. 

f irmwareCommi t 

Commits  switch  firmware. 

f irmwareDownload 

Downloads  switch  firmware  from  a  remote  host  or  local  directory. 

f irmwareDownloadStatus 

Displays  the  status  of  a  firmware  download. 

f irmwareRestore 

Restores  the  former  active  firmware  image. 
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Table  28   switchAdmin  commands  (continued) 


/-  1 

Command 

Description 

firmware Show 

Displays  the  Fabric  OS  versions  on  both  partitions  of  the  local  and 
remote  CPs. 

f portTest 

Functional  test  of  F->N,  N->F  point-to-point  path. 

f ruReplace 

Interactive  interface  to  replace  a  field  replaceable  unit  (FRU). 

f spf Show 

Displays  Fabric  Shortest  Path  First  (FSPF)  protocol  information. 

fwHelp 

Displays  Fabric  Watch  command  information. 

h 

Displays  shell  history. 

help 

Displays  help  information  for  commands. 

historyLastShow 

Displays  the  late  entry  in  the  field  replaceable  unit  (FRU)  history  log. 

historyMode 

Displays  the  mode  of  the  history  log. 

historyShow 

Displays  the  entire  field  replaceable  unit  (FRU)  history  log. 

httpCfgShow 

Displays  the  Java  plug-in  version. 

i 

Displays  a  task  summary. 

ifModeSet 

Sets  the  link  operating  mode  for  a  network  interface. 

if Mode Show 

Displays  the  link  operating  mode  for  a  network  interface. 

interf aceShow 

Displays  FSPF  interface  information. 

interopMode 

Enables  or  disables  HP  switch  interoperability  with  switches  from  other 
manufacturers. 

iodReset 

Turns  off  the  in-order  delivery  (IOD)  option. 

iodSet 

Enables  the  in-order  delivery  (IOD)  option. 

iodShow 

Displays  the  in-order  delivery  (IOD)  option  setting. 

ipAddrSet 

Sets  the  IP  address  details  for  a  switch  or  control  processor  (CP). 

ipAddrShow 

Display  the  IP  address  information  for  a  switch  or  control  processor  (CP). 

islShow 

Displays  ISL  information. 

killTelnet 

Terminates  an  open  telnet  session. 

licenseAdd 

Adds  license  keys  to  switch. 

licenseHelp 

Displays  commands  used  to  administer  license  keys. 

licenseldShow 

Displays  system  license  ID. 

licenseRemove 

Removes  the  license  key  from  the  system. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

licenseShow 

Displays  current  license  keys. 

linkCost 

Sets  or  displays  the  fabric  shortest  path  first  (FSPF)  cost  of  a  link. 

login 

Logs  in  as  new  user. 

logout 

Logs  out  from  a  telnet,  rlogin,  or  serial  port  session. 

lSDbShow 

Displays  the  Fabric  Shortest  Path  First  (FSPF)  link  state  database. 

memShow 

Displays  the  amounts  of  free  and  used  memory  in  a  switch. 

minisPropShow 

Displays  ASIC  pair  properties. 

msCapabilityShow 

Displays  the  Management  Server  (MS)  capabilities. 

msConf igure 

Configures  the  Management  Server  (MS)  access  control  list  (ACL). 

msPlatShow 

Displays  the  Management  Server  (MS)  platform  database. 

msPlatShowDBCB 

Displays  the  Management  Server  (MS)  platform  service  database 

i   mi  i 
control  block. 

msPlClearDB 

Clears  the  Management  Server  (MS)  platform  database  on  all  switches 
in  the  fabric. 

msPlMgmt Activate 

Activates  the  Management  Server  (MS)  platform  service. 

msPlMgmtDeactivate 

Deactivates  the  Management  Server  (MS)  platform  service. 

msTdDisable 

Disables  the  Management  Server  (MS)  topology  discovery  service. 

msTdEnable 

Enables  the  Management  Server  (MS)  topology  discovery  service. 

msTdReadConf ig 

Displays  the  status  of  Management  Server  (MS)  topology  discovery 
service. 

myld 

Displays  the  current  login  session  details. 

nbrStateShow 

Displays  FSPF  neighbor's  state. 

nbrStatsClear 

Resets  FSPF  interface  counters. 

nodeFind 

Displays  all  the  device  Name  Server  (NS)  entries  matching  a  given 
WWN,  device  PID,  or  alias. 

nsAliasShow 

Displays  local  Name  Server  (NS)  information,  with  aliases. 

nsAllShow 

Displays  global  name  server  information. 

nscamShow 

L'lbrjlvjyb  1 1 1 IUI 1 11U 1 IUI 1  UIJUUI  lUlllUlt:  vJUVICUb  111  lilt:  INUIIlt?  Ot:lVt?l  ^INO/ 

cache. 

nsShow 

Displays  local  Name  Server  (NS)  information. 
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/-  1 

Command 

Description 

nsZoneMember 

Displays  the  information  of  all  the  online  devices  zoned  with  the  given 
device. 

passwd 

Changes  the  password  for  a  user  level. 

pathlnf o 

Display  routing  and  statistics  information  along  a  path,  covering 
multiple  switches. 

pdShow 

Displays  data  from  a  panic  dump  file. 

perf Help 

Displays  performance  monitoring  help  information. 

pkiCreate 

Creates  public  key  infrastructure  (PKI)  objects. 

pkiRemove 

Remove  existing  public  key  infrastructure  (PKI)  objects. 

pkiShow 

Displays  existing  public  key  infrastructure  (PKI)  objects. 

portAlpaShow 

Displays  the  arbitrated  loop  physical  addresses  (AL_PAs)  of  devices 

11           1            1    1  1 

attached  to  a  port. 

portBuf f erShow 

Displays  the  buffer  usage  information  for  a  port  group  or  for  all  port 
groups  in  the  switch. 

portCamShow 

Displays  port-based  filter  CAM  utilization. 

portCf g 

Sets  a  port's  configuration  to  be  disabled  or  enabled. 

portCfgDef ault 

Restores  the  port  configuration  to  default  values. 

portCfgEPort 

Enables  or  disables  a  port  from  becoming  an  E_Port. 

portCfgGPort 

Designates  a  port  as  a  G_Port. 

portCfglSLMode 

Enables  or  disables  ISL  R_RDY  mode  on  a  port. 

portCf gLongDi stance 

Configures  a  port  to  support  longdistance  links. 

portCfgLPort 

Locks  a  port  as  an  L_Port. 

portCf gPersistentDi sable 

Disables  a  port  persistently. 

portCf gPersistentEnable 

Enables  a  port  persistently. 

portCf gShow 

Displays  port  configuration  settings. 

portCf gSpeed 

Configures  the  port  speed  level. 

portCf gTrunkPort 

Configures  a  port  to  be  enabled  or  disabled  for  HP  ISL  Trunking  license. 

portDebug 

Sets  debug  level  and  verbose  level  of  port  modules. 

portDisable 

Disables  a  port. 

portEnable 

Enables  a  port. 

782   MUA-based  roles 


Table  28   switchAdmin  commands  (continued) 


Command 

Description 

portErrShow 

Displays  port  error  summary. 

portFlagsShow 

Displays  the  port  status  bitmaps  for  all  ports  in  a  switch. 

portLogClear 

Clears  the  port  log. 

portLogConf igShow 

Displays  the  current  port  log  configuration. 

portLogDump 

Displays  the  port  log  without  page  breaks. 

portLogDumpPort 

Displays  the  port  log  of  specified  port,  without  page  breaks. 

portLogEventShow 

Displays  information  about  port  log  events. 

portLoginShow 

Displays  port  login  status. 

portLogPdisc 

Sets  or  clears  the  debug_pdisc_f  lag. 

portLogReset 

Enables  the  port  log  facility. 

portLogResize 

Resizes  the  port  log  to  the  specified  number  of  entries. 

portLogShow 

Displays  the  port  log. 

portLogShowPort 

Displays  the  port  log  of  specified  port,  with  page  breaks. 

portLogTypeDi sable 

Disables  the  port  log  of  a  specified  type. 

portLogTypeEnable 

Enables  the  port  log  of  a  specified  type. 

portName 

Assigns  or  displays  a  port  name. 

por t Per f Show 

Displays  port  throughput  performance  in  bytes,  kilobytes,  or  megabytes. 

portRouteShow 

Displays  routing  tables  for  the  specified  port. 

portShow 

Displays  port  status. 

portStats64Show 

Displays  the  64-bit  hardware  statistics  for  a  port. 

ports tat sClear 

Clears  the  hardware  statistics  of  a  specified  switch  port. 

port Stats Show 

Displays  port  hardware  statistics. 

portRouteShow 

Swaps  area  numbers  of  two  ports. 

port SwapDi sable 

Disables  the  portswap  feature. 

portSwapEnable 

Enables  the  portswap  feature. 

portSwapShow 

Displays  the  state  of  the  portswap  feature. 

psShow 

Displays  power  supply  status. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

qloopAdd 

Adds  a  member  to  a  QuickLoop. 

qloopCreate 

Creates  a  QuickLoop. 

qloopDelete 

Deletes  a  QuickLoop. 

qloopRemove 

Removes  a  member  from  a  QuickLoop. 

qloopShow 

Displays  QuickLoop  information. 

quietMode 

Sets  or  clears  the  telnet  session  quiet  mode,  or  displays  the  current 
mode. 

reboot 

Reboots  either  one  control  processor  (CP)  or  the  entire  system. 

routeHelp 

Displays  a  list  of  FSPF-related  commands. 

saveCore 

Saves  or  removes  core  files  created  by  daemons. 

secHelp 

Displays  information  about  security  commands. 

sensorShow 

Displays  sensor  readings. 

setDbg 

Sets  debug  level  of  the  specified  module. 

setEsdMode 

Enables  or  disables  ESD  mode. 

setGbicMode 

Enables  or  disables  media  mode. 

setMediaMode 

Enables  or  disables  media  mode. 

setModem 

Enables  or  disables  modem  dial-in  to  a  control  processor  (CP). 

setSfpMode 

Enables  or  disables  media  mode. 

setVerbose 

Specifies  module  verbose  level. 

sf pShow 

Displays  serial  ID  SFP  information. 

shellFlowCon.tr  olDi  sable 

Disables  XON/XOFF  flow  control  on  the  console  serial  ports. 

shellFlowControlEnable 

Enables  XON/XOFF  flow  control  on  the  console  serial  ports. 

slotOn 

Enables  a  blade  slot. 

slotPowerOf f 

Removes  power  from  a  slot. 

slotPowerOn 

Restores  power  to  a  slot. 

slotShow 

Displays  the  status  of  all  slots  in  the  system. 

snmpConf ig 

Manages  the  SNMP  agent  configuration. 

snmpMibCapSet 

Modifies  options  for  configuring  SNMP  MIB  trap  capability. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

snmpMibCapShow 

Displays  options  for  configuring  SNMP  MIB  trap  capability. 

supportShow 

Displays  switch  information  for  debugging  purposes. 

supportShowCfgDi sable 

Disables  a  group  of  commands  under  the  supportShow  command. 

support ShowCf gEnable 

Enables  a  group  of  commands  under  the  supportShow  command. 

support ShowCf gShow 

Displays  the  groups  of  commands  enabled  for  display  by  the 

supportShow  command. 

switchBeacon 

Sets  switch  beaconing  mode  on  or  off. 

switchCf gPersistentDi sable 

Disables  a  switch  persistently. 

switchCf gPersistentEnable 

Enables  a  switch  persistently. 

switchCf gSpeed 

Configures  all  ports  of  a  switch  to  a  particular  speed. 

switchCf gTrunk 

Enables  or  disables  trunking  on  all  the  ports  of  a  switch. 

switchDi sable 

Disables  the  switch. 

switchEnable 

Enables  the  switch. 

switchName 

Displays  or  sets  the  switch  name. 

switchShow 

Displays  switch  and  port  status. 

switchStatusPolicySet 

Sets  the  policy  parameters  that  determine  overall  switch  status. 

switchStatusShow 

Displays  the  policy  parameters  that  determine  overall  switch  status. 

switchStatusShow 

Displays  overall  switch  status. 

switchUptime 

Displays  the  amount  of  time  the  switch  has  been  operating. 

syslogdlpAdd 

Adds  the  IP  address  of  a  syslog  daemon. 

syslogdlpRemove 

Removes  the  IP  address  of  a  syslog  daemon. 

syslogdlpShow 

Displays  all  syslog  daemon  IP  addresses. 

systemVerif ication 

Runs  a  suite  of  diagnostic  tests  on  all  switches  in  a  fabric. 

tempShow 

Displays  temperature  readings. 

timeout 

Sets  or  displays  the  idle  timeout  value  for  a  login  session. 

topologyShow 

Displays  the  unicast  fabric  topology. 

traceDump 

1  lien  /"n  v  i  c     i  n  ifi     t/~\  c     /~\  r  r~/~\  rv-i  /-\\  //-\  c        t  r/"^  f  f~\      i  i  m  v~\ 

L^ispiays,  iniTiaTes,  or  removes  a  Trace  aump. 

traceFtp 

Displays,  enables,  or  disables  the  trace  auto-FTP  or  FTPsa  trace  clump 
file  to  the  customer  FTP  server. 
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Table  28   switchAdmin  commands  (continued) 


Command 

Description 

traceTrig 

Sets,  removes,  or  displays  trace  triggers. 

trackChangesHelp 

Displays  information  on  track-changes  feature  commands. 

trunkDebug 

Debugs  a  trunk  link  failure. 

trunkShow 

Displays  trunking  information. 

tsClockServer 

Displays  or  sets  the  NTP  Server  address. 

tsTimeZone 

Displays  or  sets  the  system  time  zone. 

upTime 

Displays  how  long  the  switch  has  been  up. 

uRouteConf ig 

Configures  a  static  route. 

uRouteRemove 

Removes  a  static  route. 

uRouteShow 

Displays  unicast  routing  information. 

userConf ig 

Manages  user  accounts. 

version 

Displays  firmware  version  information. 

volt Show 

Displays  current  level  of  the  voltage  sensors  on  a  system. 

wwn 

Displays  a  switch  world  wide  name  (WWN). 

zoneHelp 

Displays  help  information  for  zone  commands. 
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6   Control  processor  commands 


This  chapter  lists  the  commands  available  when  logged  in  to  the  active  CP  and  standby  CP  in  an  HP 
StorageWorks  Core  Switch  2/64,  HP  StorageWorks  SAN  Director  2/128,  or  HP  StorageWorks  4/256 
SAN  Director. 


Commands  supported  on  the  active  CP 

When  logged  in  to  the  active  CP  on  a  Core  Switch  2/64,  you  must  specify  the  logical  switch  number  to 
which  you  are  connecting.  This  guarantees  that  any  commands  you  execute  are  run  on  the  desired 
logical  switch.  Once  you  have  selected  a  logical  switch,  the  full  set  of  commands  for  your  user  level  are 
available. 


Commands  supported  on  the  standby  CP 

The  following  commands  are  supported  when  logged  into  the  standby  CP. 
Table  29   Commands  supported  on  the  standby  CP 


Command 

Description 

date 

Print/set  the  system  date  and  time. 

errClear 

Clear  error  log. 

errDump 

Print  error  log  (no  page  breaks). 

f astBoot 

Reboot  this  switch,  bypassing  POST. 

fi rmwar eCommit 

Commit  firmware  to  stable  storage. 

fi rmwar eDownload 

Download  firmware  into  switch. 

f irmwareDownloadStatus 

Display  the  progress  and  status  of  firmwaredownload. 

fi rmwar eRes tore 

Restore  the  old  firmware  in  the  switch. 

f irmwareShow 

Display  firmware  versions  in  the  switch. 

h 

Print  shell  history. 

haDump 

Dump  HA  debug  data. 

ha Show 

Print  High  Availability  status. 

help 

Print  this  list. 

ifModeSet 

Set  the  link  operating  mode  for  a  network  interface. 

ifModeShow 

Display  the  link  operating  mode  for  a  network  interface. 
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Table  29   Commands  supported  on  the  standby  CP  (continued) 


Command 

Description 

itemList 

Lists  parameter  syntax  information. 

killTelnet 

Terminate  telnet/serial  login  sessions  interactively. 

memShow 

Display  memory  usage  in  the  system. 

my  Id 

Display  the  current  login  session  details. 

pdShow 

Display  information  from  panic  dump  file. 

reboot 

Reboot  the  standby  CP. 

saveCore 

FTP  or  remove  core  files  generated  by  daemons. 

switchName 

Print  this  switch's  name. 

tsTimeZone 

Display  time  zone. 

upTime 

Print  how  long  switch  has  been  up. 

version 

Print  firmware  version. 
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7   supports  how  reference 


This  chapter  explains  the  information  displayed  by  the  supportShow  command.  This  chapter  has  the 
following  sections: 

•  supportShow  control  commands,  page  789 

•  supportShow  command  groups,  page  789 

•  Proc  entry  information  displayed,  page  792 


supportShow  control  commands 

The  supportShow  command  is  used  to  display  support  information  by  executing  groups  of  preselected 
Fabric  OS  and  Linux  commands.  The  information  displayed  by  the  supportShow  command  can  be 
controlled  by  a  set  of  control  commands: 

supportShowCf  gShow  Display  which  groups  of  commands  are  enabled  to  display 

under  supportShow. 

supportShowCf  gEnable  Enable  a  group  of  commands  to  display  under 

supportShow. 

supportShowCf  gDisable        Disable  a  group  of  commands  from  displaying  under 

supportShow. 


supportShow  command  groups 

Table  30  displays  the  command  groups  under  supportshow,  and  which  Fabric  OS  or  Linux  commands 
are  executed  by  that  group. 


NOTE:  Many  of  the  commands  executed  by  supportShow  are  intended  for  support  use  only.  These 
commands  are  not  intended  for  end  users. 


Table  30    supportShow  command  groups 


Command  group 

Fabric  OS  3.2.0 

Fabric  OS  4.4.0 

OS 

mqshow 
i 

memShow 
mallocshow 
f astcheckheap 

mii-tool  -w 
/usr/bin/du  -xh  / 
/bin/sort : 
/bin/ps  -elfh 
/bin/echo  /bin/rpm  -qa 
/bin/cat 
/var/log/dmesg 
/bin/cat  /etc/fstab 
/bin/cat  /etc/mtab 
printing  proc  entries . 

exception 

f aultshow 
traceshow 

errDump 

errdump  -a/-p 
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Table  30    supportshow  command  groups  (continued) 


Command  group 

Fabric  OS  3.2.0 

Fabric  OS  4.4.0 

port 

portShow 

diagShow 

portregshow 

portShow 

ports true tshow 

portloginshow 

bloomdatashow 

portregshow 

portRouteShow 

portRouteShow 

portsemshow 

bloomsemshow 

semashow  1 

fabric 

f abricShow 

f abricShow 

islShow 

islShow 

trunkShow 

trunkShow 

topologyShow 

topologyShow 

f ashow 

f abStateResize 

qlshow 

f abSwitchShow 

cf gShow 

f abStatsShow 

f abStatsShow 

f abPortShow 

f ablogdump 

f spf Show 

f cplogshow 

zone-stateshow 

portzoneshow 

portCamShow 

cf gSize 

cf gShow 

rcssmshow 

rcsinf oshow 

rcsregistryshow 

services 

nsShow 

f dmiCacheShow 

nsAllShow 

ficonDbg  dump  rnid 

nscamShow 

ficonDbg  log 
f  iconShow  ilir 
f  iconShow  lirr 
f  iconShow  rlir 
f  iconShow  rnid 
f dmiShow 
nsShow 
nsAllShow 
nscamShow 

security 

secModeShow 

secModeShow 

secPolicyDump 

secPolicyDump 

secStatsShow 

secStatsShow 

secFabricShow 

secFabricShow 

network 

ipAddrShow 

/ sbin/bootenv 

if show 

/sbin/sin 

ipstatshow 

/bin/dt 

udpstatshow 

/sbm/ifconfig 

tcpstatshow 

/sbin/route 

inetstatshow 

/bin/hostname 

mbuf show 

arpshow 

routeshow 

routes tat show 

ho st show 

f eidumpprint 

i557dump 

f ei iter at erf drings 

portlog 

portLogDump  (no 
parameters ) 
portLogDump  0 ,  1 

portLogDump 
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Table  30    supportshow  command  groups  (continued) 


Command  group 

Fabric  OS  3.2.0 

Fabric  OS  4.4.0 

system 

version 

my  Id 

upTime 

version 

switchShow 

f irmwareShow 

temp Show 

upTime 

psShow 

switchStatusShow 

licenseShow 

switchShow 

diagShow 

haDump 

portF lags Show 

temp Show 

port Err Show 

sensorShow 

portCf gShow 

psShow 

conf igShow 

f anShow 

licenseShow 

portFlagsShow 

portCf gShow 

s  f pShow 

portErrShow 

fwSamShow 

agtCf gShow 

slot Show 

chassisShow 

swi tchStatusPolicyShow 

fwAlarmsFilterShow 

timeout 

historyShow 

conf igShow 

extend 

bloomlistdisplay 

ptbuf show 

bloomfde  t  show 

pt credit show 

bio  omr  amdump 

ptDataShow 

ptPhantomShow 

ptPropShow 

ptStatsShow 

filter 

f iltershow 

f ilterportshow 

perfmon 

ps_dump 

ps_dump  -a  -n  port# 
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Proc  entry  information  displayed 

The  os  command  group  prints  a  number  of  proc  entries.  Table  31  displays  example  proc  entry 
information. 


Table  31    proc  entry  information  displayed 


Prnr  riicnlnv  mmmnnn 
r  iul  uiDiJiuy        i ii i iui iu 

Pmr  oynmnlo  riicnlnv 
nut  cauiiiijic  uidijiuv 

/proc/ cmdline 

/proc/ cmdline 

quiet 

/proc/cpuinf o 

/proc/cpuinf o 

cpu  :  405GP 

clock  :  200MHz 

revision  :   1.69    (pvr  4011  0145) 

bogomips   :  199.47 

machine   :  Brocade  Silkworm 

plb  bus  clock  :  100MHz 

pci  bus  clock  :  33MHz 

/pr oc7 devices 

/proc /devices 

Character  devices: 

1  mem 

2  pty 

3  ttyp 

4  ttyS 

5  cua 

7  vcs 

10  misc 

Qq  i9p 

90  mtd 

128  ptm 

136  pts 

162  raw 

245  swd 

246  ham 

O  A  "7     f  P 

24o  fc-switcn 

24y  taJosys 

ZDU    ESS  KX 

251  tss_uata 

zoz  ess  mgmc 

253  portlog 

zj4  piatzrorm 

Block  devices: 

1  ramdisk 

3  ideO 

7  loop 

/proc/ f ilesystems 

/proc/ f ilesystems 

nodev  rootfs 

nodev  bdev 

nodev  proc 

nodev  sockfs 

nodev  tmpfs 

nodev  shm 

nodev  pipefs 

ext2 

nodev  ramfs 

nodev  nfs 

nodev  devpts 

xf  s 

nodev  dfs 
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Table  31    proc  entry  information  displayed  (continued) 


Proe  di^nlav  command 

Proc  example  display 

/proc /interrupts 

/proc /interrupts 

CPUO 

0: 

0 

IBM  UIC  Level  serial 

1  : 

591  IBM  UIC  Level  serial 

2  : 

2696197  IBM  UIC  Level  IBM  OCP  IIC 

10 

0    IBM  UIC  Level   OCP  EMAC  MAL  SERR 

11 

1512   IBM  UIC  Level  OCP  EMAC  TX  EOB 

12 

343895   IBM  UIC  Level  OCP  EMAC  RX  EOB 

13 

0    IBM  UIC  Level   OCP  EMAC  TX  DE 

14 

0   IBM  UIC  Level  OCP  EMAC  RX  DE 

26 

52017  IBM  UIC  Level  bloom 

30 

1060300  IBM  UIC  Level  ideO 

FIT: 

0 

PIT: 

15879069 

BAD: 

0 

/proc/meminf o 

/proc /meminf o 

total:  used:   free:  shared:  buffers:  cached: 

Mem: 

129740800   97079296  32661504   0  118784  45764608 

Swap 

0   0  0 

MemTotal:   12  67  00  kB 

MemFree:   31896  kB 

MemShared:   0  kB 

Buffers:   116  kB 

Cached:   44692  kB 

SwapCached :    0  kB 

Active:   23464  kB 

Inactive:   49472  kB 

HighTotal :   0  kB 

HighFree:   0  kB 

LowTotal:   126700  kB 

LowFree:   31896  kB 

SwapTotal :   0  kB 

SwapFree:   0  kB 

/proc /modules 

/proc/modules 

dubby-module  582614  2 

chubby-module  3128618  126  [dubby-module] 

dfs  5458  1  [dubby-module] 

consolelog-module  8539  0  (unused) 

panicdump-module  15279  0  [chubby-module 

consolelog-module] 

xf snotif icationhandler  4858  0  (unused) 

/proc /mounts 

/proc/mounts 

rootfs  /  rootfs  rw  0  0 

dev/hdal  /  xfs  rw,noatime  0  0 

/proc  /proc  proc  rw  0  0 

none 

/dev/pts  devpts  rw  0  0 

none 

/tmp  ramfs  rw  0  0 

/dev/hda2  /mnt  xfs  rw,noatime  0  0 

/diag  /diag  dfs  rw  0  0 

/proc/mtd 

/proc/mtd 

dev: 

size  erasesize  name 

mtdO 

00010000  00010000   "boot  environment" 

mtdl 

00070000  00010000   "boot  prom" 

mtd2 

01000000  00040000   "Entire  user  flash" 

mtd3 

00400000  00040000   "kernel  and  initrd   (1) " 

mtd4 

00400000  00040000   "kernel  and  initrd  (2)" 

mtd5 

00400000  00040000  "log  data  (1)" 

mtd6 

00400000  00040000   "log  data  (2)" 

/nTnr  /n^rt"  l  t  i  nns 

/         J-  L. I  ' —  /         Ci-L.   1  LI  L  Ull  O 

/proc /partitions 

major  minor  #blocks  name 

3  0  250880  hda 

3  1  124912  hdal 

3  2  124928  hda2 
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Table  31    proc  entry  information  displayed  (continued) 


Proc  display  command 

Proc  example  display 

/proc/pci 

/proc/pci 

PCI  devices  found: 

Bus  0,   device  0,    function  0: 

Host  bridge:   IBM  405GP  PLB  to  PCI  Bridge   (rev  1) . 

Master  Capable.   Latency=7 . 

Preretcnable  32  bit  memory  at  0x0    [Ox/frfffff J  . 

Bus  0,   device  4,    function  0: 

IDE  interface:   CMD  Technology  Inc  PCI0649    (rev  2) . 

IRQ  30. 

Master  Capable.   Latency=64.  Min  Gnt=2.Max  Lat=4 . 

I/O  at  0x1008    [OxlOOf] . 

I/O  at  0x1000  [0x1003]. 

I/O  at  0x2000    [0x2007] . 

I/O  at   0x3000    [0x30U3J  . 

I/O  at  0x4000    [0x400f] . 

Bus  0 ,   device  6 ,    function  0 : 

Non-VGA  unclassified  device:  Brocade  Communications 

Systems,    Inc.   Bloom  switch   (rev  0). 

IRQ  26. 

--<output  truncated>-- 

/proc/ slabinf o 

/proc/ slabinf o 

slabinf o  -  version:  1.1 

1  "U.             ""7/1       i   n  ^       1   1   O       T       T  1 

kmem_cacne   /4  102  112  3  3  1 

ip_mrt_cache  0  0  96  0  0  1 

tcp_tw_bucket  24096111 

tcp_bind_bucket  5  113  32  1  1  1 

tcp_open_request  0  59  64  0  1  1 

inet_peer_cache  1  59  64  1  1  1 

ip_fib_hash  11  113  32  1  1  1 

ip_dst_cache  65  168  160  7  7  1 

arp_cache  2  30  12 8111 

blkdev  requests  128  160  96  4  4  1 

xfs_chashlist  193  404  16  2  2  1 

XlS  111    zUU4    DOOo    ±DZ    1j j    zlo  1 

xfs_ifork  0  0  56  0  0  1 

xfs_efi_item  0  12  328  0  11 

xfs_efd_item  0  12  328  0  1  1 

--<output  truncated>-- 

/proc/stat 

/proc/stat 

cpu  184683  47107  88647  15558673 

cpuO  184683  47107  88647  15558673 

page  54635  71305 

swap  0  0 

intr  4154525  0  591  2696197  00000000  1520  343900 

UUUUUUUUUUUUU    dzUI /    U    U    U    IUdU jUU  U 

disk_io:    (3,0) : (61121,53  52,115463,55769,94483  5) 

ctxt  44089966 

btime  1048729603 

processes  17684 

/proc/ tty/ drivers 

/proc / tty /drivers 

serial  /dev/cua  5  64-65  serial : callout 

serial  /dev/ttyS  4  64-65  serial 

pty_slave  /dev/pts  136  0-255  pty: slave 

pty_master  /dev/ptm  128  0-255  pty:master 

pty_slave  /dev/ttyp  3  0-255  pty: slave 

Titv  master"    /dpv/ntv   9    0  —  955  nt"VTn^^t"pr 

/dev/vc/0  /dev/vc/0  4  0  system : vtmaster 

/dev/ptmx  /dev/ptmx  5  2  system 

/dev/console  /dev/console  5  1  system: console 

/dev/tty  /dev/tty  5  0  system: /dev/tty 
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Table  31    proc  entry  information  displayed  (continued) 


Proc  display  command 

Proc  example  display 

/proc/uptime 

/proc/uptime 
158791.21  155710.77 

/proc /vers ion 

/proc /version 

Linux  version  2.4.19    ( swrel@sierra)    (gcc  version 
2.95.3  20010112    (prerelease))    #1  Wed  Mar  26  00:04:35 
PST  2003 
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Glossary 


8b/ 10b  encoding 
address  identifier 
ALPA 
ALTIME 
alias 


alias  address 
identifier 

alias  AL  PA 


alias  server 
ANSI 

arbitrated  loop 

arbitration 
area  number 


ARP 

ARR 

ASD 

ASIC 
ATM 

authentication 


An  encoding  scheme  that  converts  each  8-bit  byte  into  10  bits.  Used  to  balance  Is  and  0s  in 
high-speed  transports. 

A  24-bit  or  8-bit  value  used  to  identify  the  source  or  destination  of  a  frame.  See  also  S  ID 
and  D_ID. 

Arbitrated-loop  physical  address.  A  unique  8-bit  value  assigned  during  loop  initialization  to  a 
port  in  an  arbitrated  loop. 

Arbitrated-loop  timeout  value.  Twice  the  amount  of  time  it  would  take  for  a  transmission  word 
to  propagate  around  a  worst-case  loop.  The  default  value  is  15  milliseconds  (ms). 

A  logical  grouping  of  elements  in  a  fabric.  An  alias  is  a  collection  of  port  numbers  and 
connected  devices,  used  to  simplify  the  entry  of  port  numbers  and  WWNs  when  creating 
zones. 

An  address  identifier  recognized  by  a  port  in  addition  to  its  standard  identifier.  An  alias 
address  identifier  can  be  shared  by  multiple  ports.  See  also  alias. 

An  AL_PA  value  recognized  by  an  L  Port  in  addition  to  the  AL  PA  assigned  to  the  port.  See 
also  AL  PA. 

A  fabric  software  facility  that  supports  multicast  group  management. 
American  National  Standards  Institute. 

A  shared  100-Mb/sec  Fibre  Channel  transport  structured  as  a  loop.  Can  support  up  to  126 
devices  and  one  fabric  attachment.  See  also  topology. 

A  method  of  gaining  orderly  access  to  a  shared-loop  topology. 

In  HP  Fabric  OS  v4.0  and  above,  ports  on  a  switch  are  assigned  a  logical  area  number.  Port 
area  numbers  can  be  viewed  by  entering  the  switchShow  command.  They  are  used  to 
define  the  operative  port  for  many  Fabric  OS  commands:  for  example,  area  numbers  can  be 
used  to  define  the  ports  within  an  alias  or  zone. 

Address  Resolution  Protocol.  A  TCP/IP  function  for  associating  an  IP  address  with  a  link-level 
address. 

Asynchronous  response  router.  Refers  to  Management  Server  GS_Subtype  Code  E4,  which 
appears  in  portLogDump  command  output. 

Alias  server  daemon.  Used  for  managing  multicast  groups  by  supporting  the  create,  add, 
remove,  and  destroy  functions. 

Application-specific  integrated  circuit. 

Asynchronous  Transfer  Mode.  A  transport  used  for  transmitting  data  over  LANs  or  WANs  that 
transmit  fixed-length  units  of  data.  Provides  any-to-any  connectivity  and  allows  nodes  to 
transmit  simultaneously. 

The  process  of  verifying  that  an  entity  in  a  fabric  (such  as  a  switch)  is  what  it  claims  to  be.  See 
also  digital  certificate,  switch-to-switch  authentication. 


Fabric  OS  5.x  command  reference  guide  797 


autocommit 

auforeboof 
AWJOV 

backbone  fabric 

backup  FCS  switch 

BB  fabric 

BB_Credit 

beacon 


beginning  running 
disparity 

BER 


BISR 
BIST 

bit  synchroniza-tion 
Bloom 

boot  code 

boot  flash 
broadcast 


buffer-to-buffer  flow 
control 

bypass  circuitry 


CA 


A  feature  of  the  f  irmwareDownload  command.  Enabled  by  default,  autocommit  commits 
new  firmware  to  both  partitions  of  a  control  processor. 

Refers  to  the  -b  option  of  the  f  irmwareDownload  command.  Enabled  by  default. 

Arbitration  wait  timeout  value.  The  minimum  time  an  arbitrating  L_Port  waits  for  a  response 
before  beginning  loop  initialization. 

An  optional  capability  that  enables  scalable  meta-SANs  by  allowing  the  networking  of 
multiple  FC  routers,  which  connect  to  the  backbone  fabric  via  EB_Port  interfaces. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  The  backup  fabric  configuration  server  serves  as  a 
backup  in  case  the  primary  FCS  switch  fails.  See  also  FCS  switch,  primary  FCS  switch. 

A  backbone  fabric  that  connects  FC  Routers.  The  FC  Routers  communicate  over  the  backbone 
fabric  using  FCRP  (Fibre  Channel  Router  Protocol). 

Buffer-to-buffer  credit.  The  number  of  frames  that  can  be  transmitted  to  a  directly  connected 
recipient  or  within  an  arbitrated  loop.  Determined  by  the  number  of  receive  buffers  available. 
See  also  buffer-to-buffer  flow  control,  EE_Credit. 

A  tool  in  which  all  of  the  port  LEDs  on  a  switch  are  set  to  flash  from  one  side  of  the  switch  to 
the  other,  to  enable  identification  of  an  individual  switch  in  a  large  fabric.  A  switch  can  be  set 
to  beacon  by  a  CLI  command  or  through  HP  Advanced  Web  Tools. 

The  disparity  at  the  transmitter  or  receiver  when  the  special  character  associated  with  an 
ordered  set  is  encoded  or  decoded.  See  also  disparity. 

Bit  error  rate.  The  rate  at  which  bits  are  expected  to  be  received  in  error.  Expressed  as  the  ratio 
of  error  bits  to  total  bits  transmitted.  See  also  error. 

Built-in  self-repair. 

Built-in  self-test. 

The  condition  in  which  a  receiver  is  delivering  retimed  serial  data  at  the  required  bit  error  rate. 

The  code  name  given  to  the  third-generation  HP  Fabric  ASIC.  This  ASIC  is  used  in 
StorageWorks  2  GB  switches  and  beyond. 

Software  that  initialized  the  system  environment  during  the  early  phase  of  the  boot-up  process. 
For  example,  boot  code  might  determine  the  amount  of  available  memory  and  how  to  access 
it. 

Flash  (temporary)  memory  that  stores  the  boot  code  and  boot. 

The  transmission  of  data  from  a  single  source  to  all  devices  in  the  fabric,  regardless  of  zoning. 
See  also  multicast,  unicast. 

Management  of  the  frame  transmission  rate  in  either  a  point-to-point  topology  or  in  an 
arbitrated  loop.  See  also  BB  Credit. 

Circuits  that  automatically  remove  a  device  from  the  data  path  when  valid  signals  are 
dropped. 

Certificate  authority.  A  trusted  organization  that  issues  digital  certificates.  See  also  digital 
certificate. 


CAM 


Content-addressable  memory. 
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cascade 

CDR 
CE 
CFG 
CFN 

chassis 
CIM 

Class  1  service 

Class  2  service 
Class  3  service 

Class  4  service 
Class  6  service 
Class  F  service 

class  of  service 
CLS 

CM 

CMA 

CMBISR 

CMT 

comma 

community  (SNMP) 
compact  flash 


Two  or  more  interconnected  Fibre  Channel  switches.  HP  StorageWorks  1  GB/s  switches  and 
later  switches  can  be  cascaded  up  to  239  switches,  with  a  recommended  maximum  of  seven 
interswitch  links  (no  path  longer  than  eight  switches).  See  also  fabric,  ISL. 

Clock  and  data  recovery  circuitry. 

Conformite  Europeenne. 

Configuration. 

Change  fabric  name.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

The  metal  frame  in  which  the  switch  and  switch  components  are  mounted. 

Common  Information  Model.  A  management  structure  enabling  disparate  resources  to  be 
managed  by  a  common  application. 

The  class  of  frame-switching  service  for  a  dedicated  connection  between  two  communicating 
ports  (also  called  connection-oriented  service).  Includes  acknowledgement  of  frame  delivery  or 
nondelivery. 

A  connectionless  class  of  frame-switching  service  that  includes  acknowledgement  of  frame 
delivery  or  nondelivery. 

A  connectionless  class  of  frame-switching  service  that  does  not  include  acknowledgement  of 
frame  delivery  or  nondelivery.  Can  be  used  to  provide  a  multicast  connection  between  the 
frame  originator  and  recipients,  with  acknowledgement  of  frame  delivery  or  nondelivery. 

A  connection-oriented  service  that  allows  fractional  parts  of  the  bandwidth  to  be  used  in  a 
virtual  circuit. 

A  connection-oriented  multicast  service  geared  toward  video  broadcasts  between  a  central 
server  and  clients. 

The  class  of  frame-switching  service  for  a  direct  connection  between  two  switches,  allowing 
communication  of  control  traffic  between  the  E  Ports.  Includes  acknowledgement  of  data 
delivery  or  nondelivery. 

A  specified  set  of  delivery  characteristics  and  attributes  for  frame  delivery. 

Close  primitive  signal.  Used  only  in  an  arbitrated  loop.  Sent  by  an  L_Port  that  is  currently 
communicating  in  the  loop,  to  close  communication  with  another  L_Port. 

Central  memory. 

Central  memory  architecture.  An  architecture  centralizing  memory  usage  in  switches. 
Central  memory  built-in  self-repair. 
Central  memory  test. 

A  unique  pattern  (either  1 100000  or  001 1111)  used  in  8b/10b  encoding  to  specify 
character  alignment  within  a  data  stream. 

A  relationship  between  a  group  of  SNMP  managers  and  an  SNMP  agent,  in  which 
authentication,  access  control,  and  proxy  characteristics  are  defined.  See  also  SNMP. 

Flash  (temporary)  memory  that  is  used  in  a  manner  similar  to  hard  disk  storage.  It  is  connected 
to  a  bridging  component  that  connects  to  the  PCI  bus  of  the  processor.  Not  visible  within  the 
processor's  memory  space. 
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configuration 


congestion 

connection  initiator 

connection  recipient 

controller 

COS 
CP 
CRC 
credit 

cut-through 

D_ID 

DAS 

data  word 
DCC 

dedicated  simplex 


defined  zone 
configuration 

deskew 


DHCP 
DHCPD 


(1 )  A  set  of  parameters  that  can  be  modified  to  fine-tune  the  operation  of  a  switch.  Use  the 
conf  igShow  command  to  view  the  current  configuration  of  your  switch. 

2)  In  HP  Zoning,  a  zoning  element  that  contains  a  set  of  zones.  The  Configuration  is  the 
highest-level  zoning  element  and  is  used  to  enable  or  disable  a  set  of  zones  on  the  fabric.  See 
also  zone  configuration. 

The  realization  of  the  potential  of  oversubscription.  A  congested  link  is  one  on  which  multiple 
devices  are  contending  for  bandwidth. 

A  port  that  has  originated  a  Class  1  dedicated  connection  and  received  a  response  from  the 
recipient. 

A  port  that  has  received  a  Class  1  dedicated  connection  request  and  transmitted  a  response  to 
the  originator. 

A  computer  module  that  interprets  signals  between  a  host  and  a  peripheral  device.  The 
controller  typically  is  part  of  the  peripheral  device. 

Class  of  service. 

Control  processor. 

Cyclic  redundancy  check.  A  transmission  error  check  that  is  included  in  every  data  frame. 

As  it  applies  to  Fibre  Channel  technology,  the  number  of  receive  buffers  available  to  transmit 
frames  between  ports.  See  also  BB  Credit,  EE  Credit. 

A  switching  technique  that  allows  the  route  for  a  frame  to  be  selected  as  soon  as  the 
destination  address  is  received.  See  also  route. 

Destination  identifier.  A  3-byte  field  in  the  frame  header,  used  to  indicate  the  address  identifier 
of  the  N_Port  to  which  the  frame  is  headed. 

Direct  attached  storage. 

A  type  of  transmission  word  that  occurs  within  frames.  The  frame  header,  data  field,  and  CRC 
all  consist  of  data  words.  See  also  frame,  ordered  set,  transmission  word. 

Direct  cable  connection.  DCC  does  not  require  network  interface  cards  (NICs),  making  it 
relatively  inexpensive  and  simple;  however,  it  provides  a  limited  connection  between  two  PCs, 
and  the  data  transfer  rate  is  slower  than  with  a  true  LAN. 

A  connection  method  that  permits  a  single  N_Port  to  simultaneously  initiate  a  session  with  one 
NPort  as  an  initiator  and  have  a  separate  Class  1  connection  to  another  NPort  as  a 
recipient. 

The  set  of  all  zone  objects  defined  in  the  fabric.  Can  include  multiple  zone  configurations.  See 
also  enabled  zone  configuration,  zone  configuration. 

Related  to  the  HP  Trunking  feature.  The  time  difference  between  traffic  traveling  over  each  ISL 
other  than  the  shortest  ISL  in  the  group  and  traffic  traveling  over  that  shortest  ISL.  The  deskew 
number  corresponds  to  nanoseconds  divided  by  10.  The  firmware  automatically  sets  the 
minimum  deskew  value  of  the  shortest  ISL  to  1 5. 

Dynamic  Host  Configuration  Protocol. 

Dynamic  Host  Configuration  Protocol  daemon. 


800  Glossary 


digital  certificate 

disparity 

DLS 
DMTF 

domain  controller 
domain  ID 

DTE 

DWDM 
E_D_TOV 

E_Port 
ECCN 

edge  fabric 
EE_Credit 

EIA  rack 

ELP 

ELS 

EM 

embedded  port 
EMI 

emulex 

enabled  zone 
configuration 


An  electronic  document  issued  by  a  CA  (certificate  authority)  to  an  entity,  containing  the 
public  key  and  identity  of  the  entity.  Entities  in  a  secure  fabric  are  authenticated  based  on 
these  certificates.  See  also  authentication,  CA,  public  key. 

The  proportion  of  Is  and  Os  in  an  encoded  character.  Neutral  disparity  means  an  equal 
number  of  each,  positive  disparity  means  a  majority  of  Is,  and  negative  disparity  means  a 
majority  of  Os. 

Dynamic  load-sharing.  Dynamic  distribution  of  traffic  over  available  paths.  Allows  for 
recomputing  of  routes  when  an  Fx  Port  or  E  Port  changes  status. 

Distributed  Management  Task  Force. 

A  domain  controller  or  embedded  port  communicates  with  and  gets  updates  from  other 
switches'  embedded  ports.  The  well-known  address  is  fffcdd,  where  dd  =  domain  number). 

A  unique  identifier  for  all  switches  in  a  fabric,  used  in  routing  frames.  Usually  automatically 
assigned  by  the  principal  switch  but  can  be  assigned  manually.  The  domain  ID  for  an  HP 
StorageWorks  switch  can  be  any  integer  between  1  and  239. 

Data  terminal  equipment.  Usually  refers  to  a  terminal. 

Dense  wave  division  multiplexing.  Allows  more  wavelengths  to  use  the  same  fiber.  See  WDM. 

Error-detect  timeout  value.  The  minimum  amount  of  time  a  target  waits  for  a  sequence  to 
complete  before  initiating  recovery.  Can  also  be  defined  as  the  maximum  time  allowed  for  a 
round-trip  transmission  before  an  error  is  declared.  See  also  R_A_TOV,  RRTOV. 

Expansion  port.  A  standard  Fibre  Channel  mechanism  that  enables  switches  to  network  with 
each  other,  creating  an  ISL.  See  also  ISL. 

Export  classification  control  number.  A  government  classification  of  encryption.  For  example, 
SSH  is  in  the  high-encryption  category  (number  5x02)  and  therefore  has  certain  restrictions 
regarding  its  transfer. 

A  Fibre  Channel  fabric  connected  to  an  FC  router  via  an  EX  Port  (where  hosts  and  storage  are 
attached  in  a  meta-SAN). 

End-to-end  credit.  The  number  of  receive  buffers  allocated  by  a  recipient  port  to  an  originating 
port.  Used  by  Class  1  and  2  services  to  manage  frame  exchange  across  the  fabric,  between 
source  and  destination.  See  also  BB_Credit,  end-to-end  flow  control. 

A  storage  rack  that  meets  the  standards  set  by  the  Electronics  Industry  Association  (EIA). 

Exchange  link  parameters. 

Extended  link  service.  ELSs  are  sent  to  the  destination  N_Port  to  perform  the  requested  function 
or  service.  ELS  is  a  Fibre  Channel  standard  that  is  sometimes  referred  to  as  "Fibre  Channel 
Physical  (FC_PH)  ELS." 

Environmental  monitor.  Monitors  FRUs  and  reports  failures. 

An  embedded  port  (or  domain  controller)  communicates  and  get  updates  from  other  switches' 
embedded  ports.  The  well-known  address  is  fffcdd,  where  dd  =  domain  number. 

Electromagnetic  interference. 

A  brand  of  host  bus  adapter. 

The  currently  enabled  configuration  of  zones.  Only  one  configuration  can  be  enabled  at  a 
time.  See  also  defined  zone  configuration,  zone  configuration. 
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end-to-end  flow 
control 

entry  fabric 

EOF 

error 

EVMd 
EX_Port 

exchange 

exported  device 

FBSY 

F_Port 

FRJT 

fabric 


fabric  application 
platform 


Fabric  Manager 

Fabric  Mode 

fabric  name 
fabric  port  count 
fabric  services 
fabric  topology 
Fabric  Watch 

failover 


Governs  flow  of  Class  1  and  2  frames  between  NPorts.  See  also  EE  Credit. 

The  basic  HP  software  license  that  allows  one  E_Port  per  switch. 

End  of  frame.  A  group  of  ordered  sets  used  to  mark  the  end  of  a  frame. 

As  it  applies  to  the  Fibre  Channel  industry,  a  missing  or  corrupted  frame,  timeout,  loss  of 
synchronization,  or  loss  of  signal  (link  errors).  See  also  loop  failure. 

Event  management  database.  Delivers  FDMI-related  events. 

A  type  of  E  Port  that  connects  an  FC  router  to  an  edge  fabric.  EX  Ports  limit  the  scope  of 
fabric  services  scope  but  provide  device  connectivity  using  FC-NAT. 

The  highest-level  Fibre  Channel  mechanism  used  for  communication  between  N_Ports. 
Composed  of  one  or  more  related  sequences,  it  can  work  in  either  one  or  both  directions. 

A  device  that  has  been  mapped  between  fabrics  (a  host  or  storage  port  in  one  edge  fabric 
can  be  exported  to  any  other  fabric  by  using  LSAN  zoning). 

Fabric  port  busy  frame.  A  frame  issued  by  the  fabric  to  indicate  that  a  frame  cannot  be 
delivered  because  the  fabric  or  destination  N_Port  is  busy. 

Fabric  port.  A  port  that  is  able  to  transmit  under  fabric  protocol  and  interface  over  links.  Can 
be  used  to  connect  an  N_Port  to  a  switch.  See  also  FLPort,  Fx  Port. 

Fabric  port  reject  frame.  A  frame  issued  by  the  fabric  to  indicate  that  delivery  of  a  frame  is 
being  denied,  perhaps  because  a  class  is  not  supported,  there  is  an  invalid  header,  or  no 
N_Port  is  available. 

A  collection  of  Fibre  Channel  switches  and  devices,  such  as  hosts  and  storage.  Also  referred  to 
as  a  switched  fabric.  See  also  cascade,  SAN,  topology. 

A  device  that  enables  fabric-based  storage  applications  such  as  mirroring,  data  migration, 
snapshots,  and  virtual  tape.  The  HP  StorageWorks  Fabric  Application  Platform  can  run  in  a 
central  location,  process  data  at  wire-speed,  and  reside  in  existing  data  paths. 

An  optionally  licensed  HP  software.  Fabric  Manager  is  a  GUI  that  allows  for  fabric-wide 
administration  and  management.  Switches  can  be  treated  as  groups,  and  actions  such  as 
firmware  downloads  can  be  performed  simultaneously. 

One  of  two  possible  modes  for  an  L_Port,  in  which  the  L_Port  is  connected  to  another  port  that 
is  not  loop  capable,  using  fabric  protocol. 

The  unique  identifier  assigned  to  a  fabric  and  communicated  during  login  and  port  discovery. 

The  number  of  ports  available  for  connection  by  nodes  in  a  fabric. 

Codes  that  describe  the  communication  to  and  from  any  well-known  address. 

The  arrangement  of  switches  that  form  a  fabric. 

An  optionally  licensed  HP  software.  Fabric  Watch  can  be  accessed  through  either  the 
command  line  or  Advanced  Web  Tools,  and  it  provides  the  ability  to  set  thresholds  for 
monitoring  fabric  conditions. 

Describes  the  Core  Switch  2/64  process  of  one  CP  passing  active  status  to  another  CP.  A 
failover  is  nondisruptive. 
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FAN  Fabric  address  notification.  Retains  the  AL_PA  and  fabric  address  when  a  loop  reinitializes,  if 

the  switch  supports  FAN. 

fan-in  The  ratio  of  hosts  to  storage  devices;  the  view  of  the  SAN  from  the  storage  port's  perspective. 

fan-out  The  ratio  of  storage  devices  to  hosts;  the  view  of  the  SAN  from  the  host  port's  perspective. 

FC-0  Lowest  layer  of  Fibre  Channel  transport.  Represents  physical  media. 

FC-1  Layer  of  Fibre  Channel  transport  that  contains  the  8b/ 10b  encoding  scheme. 

FC-2  Layer  of  Fibre  Channel  transport  that  handles  framing  and  protocol,  frame  format, 

sequence/exchange  management,  and  ordered  set  usage. 

FC-3  Layer  of  Fibre  Channel  transport  that  contains  common  services  used  by  multiple  N_Ports  in  a 

node. 

FC-4  Layer  of  Fibre  Channel  transport  that  handles  standards  and  profiles  for  mapping  upper-level 

protocols  such  as  SCSI  and  IP  onto  the  Fibre  Channel  Protocol. 

FC-AL-3  The  Fibre  Channel  arbitrated-loop  standard  defined  by  ANSI.  Defined  on  top  of  the  FC-PH 

standards. 

FC-AV  Fibre  Channel  audio  visual. 

FC-CT  Fibre  Channel  common  transport. 

FC-FG  Fibre  Channel  generic  requirements. 

FC-FLA  The  Fibre  Channel  fabric  loop-attach  standard  defined  by  ANSI. 

FC-FS  Fibre  Channel  framing  and  signaling. 

FC-GS  Fibre  Channel  generic  services. 

FC-GS-2  Fibre  Channel  generic  services,  second  generation. 

FC-GS-3  Fibre  Channel  Generic  Services,  third  generation. 

FCIP  Fibre  Channel  over  IP. 

FC-NAT  Fibre  Channel  network  address  translation. 

FC-PH  The  Fibre  Channel  physical  and  signaling  standard  for  FC-0,  FC-1,  and  FC-2  layers  of  the 

Fibre  Channel  Protocol.  Indicates  signaling  used  for  cable  plants,  media  types,  and 
transmission  speeds. 

FC-PH-2  Fibre  Channel  Physical  Interface,  second  generation. 

FC-PH-3  Fibre  Channel  Physical  Interface,  third  generation. 

FC-PI  Fibre  Channel  Physical  Interface  standard,  defined  by  ANSI. 

FC-PLDA  The  Fibre  Channel  Private  Loop  Direct  Attach  standard  defined  by  ANSI.  Applies  to  the 

operation  of  peripheral  devices  on  a  private  loop. 

FC_SB  Fibre  Channel  single  bytes. 

FC_VI  Fibre  Channel  virtual  interface. 

FCA  Flow-control  acknowledgement  (DLSW). 
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Fibre  Channel  Industry  Association.  An  international  organization  of  Fibre  Channel  industry 
professionals.  Provides  oversight  of  ANSI  and  industry-developed  standards,  among  other 
tasks. 

The  HP  Multiprotocol  SAN  Routing  Service  that  enables  SANs  to  span  longer  distances  than 
could  be  supported  with  native  Fibre  Channel  links.  FCIP  is  a  TCP/IP-based  tunneling  protocol 
that  allows  the  transparent  interconnection  of  geographically  distributed  SAN  islands  through 
an  IP-based  network. 

Fibre  Channel  Loop  Community. 

Fibre  Channel  Protocol.  Mapping  of  protocols  onto  the  Fibre  Channel  standard  protocols.  For 
example,  SCSI  FCP  maps  SCSI-3  onto  Fibre  Channel. 

Fibre  Channel  Router  Protocol.  A  protocol  that  enables  LSAN  switches  to  perform  routing 
between  different  edge  fabrics,  optionally  across  a  backbone  fabric. 

Fibre  Channel  Routing  Service.  The  HP  Multiprotocol  SAN  Routing  Service  that  extends 
hierarchical  networking  capabilities  to  Fibre  Channel  fabrics.  Sometimes  called  "FC-to-FC 
routing,"  FCRS  enables  devices  located  on  separate  fabrics  to  communicate  without  merging 
the  fabrics.  It  also  enables  the  creation  of  LSANs. 

Fibre  Channel  switch. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  One  or  more  designated  switches  that  store  and 
manage  security  parameters  and  configuration  data  for  all  switches  in  the  fabric.  They  also  act 
as  a  set  of  backup  switches  to  the  primary  FCS  switch.  See  also  backbone  fabric,  primary  FCS 
switch. 

The  second-generation  Fibre  Channel  Switch  Fabric  standard  defined  by  ANSI.  Specifies  tools 
and  algorithms  for  the  interconnection  and  initialization  of  Fibre  Channel  switches  to  create  a 
multiswitch  Fibre  Channel  fabric. 

Fibre  Distributed  Data  Interface.  An  ANSI  architecture  for  a  metropolitan  area  network  (MAN); 
a  network  based  on  the  use  of  fiber-optic  cable  to  transmit  data  at  1 00  Mb/sec. 

Fabric-Device  Management  Interface.  FDMI  is  a  database  service  provided  by  the  fabric  for 
Nx  Ports.  The  primary  use  is  by  HBA  devices  that  register  information  about  themselves  and 
their  ports. 

Well-known  Fibre  Channel  address  for  a  Class  6  multicast  server. 
Well-known  Fibre  Channel  address  for  a  clock  synchronization  server. 
Well-known  Fibre  Channel  address  for  a  security  key  distribution  server. 
Well-known  Fibre  Channel  address  for  an  alias  server. 
Well-known  Fibre  Channel  address  for  a  QoS  facilitator. 
Well-known  Fibre  Channel  address  for  a  management  server. 
Well-known  Fibre  Channel  address  for  a  time  server. 
Well-known  Fibre  Channel  address  for  a  directory  server. 
Well-known  Fibre  Channel  address  for  a  fabric  controller. 
Well-known  Fibre  Channel  address  for  a  fabric  F_Port. 
Well-known  Fibre  Channel  address  for  a  broadcast  alias  ID. 


The  primary  protocol  used  for  building  SANs  to  transmit  data  between  servers,  switches,  and 
storage  devices.  Unlike  IP  and  Ethernet,  Fibre  Channel  was  designed  to  support  the  needs  of 
storage  devices  of  all  types.  It  is  a  high-speed,  serial,  bidirectional,  topology-independent, 
multiprotocol,  and  highly  scalable  interconnection  between  computers,  peripherals,  and 
networks. 

A  protocol  service  that  supports  communication  between  Fibre  Channel  service  providers.  See 
also  FSP. 

A  protocol  used  on  IBM  mainframes.  HP  StorageWorks  switch  FICON  support  enables  an  HP 
StorageWorks  fabric  to  transmit  FICON  format  data  between  FICON-capable  servers  and 
storage. 

Fabric  ID.  Unique  identifier  of  a  fabric  in  a  meta-SAN. 

An  IDLE  or  ARB  ordered  set  that  is  transmitted  during  breaks  between  data  frames  to  keep  the 
Fibre  Channel  link  active. 

The  basic  operating  system  provided  with  the  hardware. 

An  HP  StorageWorks  switch  feature  that  prevents  an  incompatible  version  of  the  HP  Fabric 
OS  to  be  downloaded  to  the  HP  StorageWorks  2  GB  series  switches. 

Fabric  loop  port.  A  port  that  is  able  to  transmit  under  fabric  protocol  and  also  has 
arbitrated-loop  capabilities.  Can  be  used  to  connect  an  NLPort  to  a  switch.  See  also  F_Port, 
Fx_Port. 

Programmable  nonvolatile  RAM  (NVRAM)  memory  that  maintains  its  contents  without  power. 

Fabric  login.  The  process  by  which  an  N_Port  determines  whether  a  fabric  is  present  and,  if 
so,  exchanges  service  parameters  with  it.  See  also  PLOGI. 

Fiber  Optic  Test  Procedure.  Standards  developed  and  published  by  the  Electronic  Industries 
Association  (EIA)  under  the  EIA-RS-455  series  of  standards. 

Field-programmable  device.  Interchangeable  with  "PLD". 

Field-programmable  gate  array.  An  FPD  that  allows  high  logic  capacity. 

The  partial  use  of  a  link  to  send  data  back  and  forth,  with  a  maximum  of  254  Class  4 
connections  per  N  Port. 

The  Fibre  Channel  structure  used  to  transmit  data  between  ports.  Consists  of  a  start-of-frame 
delimiter,  header,  optional  headers,  data  payload,  cyclic  redundancy  check  (CRC),  and 
end-of-frame  delimiter.  There  are  two  types  of  frames:  link  control  frames  (transmission 
acknowledgements  and  so  forth)  and  data  frames. 

A  protocol  that  uses  logical  channels,  as  used  in  X.25.  Provides  very  little  error-checking 
ability.  Discards  frames  that  arrive  with  errors.  Allows  a  certain  level  of  bandwidth  between 
two  locations  (known  as  a  committed  information  rate:  CIR)  to  be  guaranteed  by  service 
provider.  If  CIR  is  exceeded  for  short  periods  (known  as  bursts),  the  network  accommodates 
the  extra  data,  if  spare  capacity  is  available.  Frame  relay  is  therefore  known  as  bandwidth  on 
demand. 

Field-replaceable  unit.  A  component  that  can  be  replaced  onsite. 

Fibre  Channel  service.  A  service  that  is  defined  by  Fibre  Channel  standards  and  exists  at  a 
well-known  address.  For  example,  the  Simple  Name  Server  is  a  Fibre  Channel  service.  See 
also  FSP. 
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FSP 

FSPF 
FSS 


FTP 
FTS 

full  fabric 


Fibre  Channel  Service  Protocol.  The  common  protocol  for  all  fabric  services,  transparent  to  the 
fabric  type  or  topology.  See  also  FS. 

Fabric  shortest  path  first.  The  HP  routing  protocol  for  Fibre  Channel  switches. 

Fabric  OS  state  synchronization.  The  FSS  service  is  related  to  high  availability  (HA).  The 
primary  function  of  FSS  is  to  deliver  state  update  messages  from  active  components  to  their 
peer  standby  components.  FSS  determines  if  fabric  elements  are  synchronized  (and  thus  FSS 
compliant). 

File  Transfer  Protocol. 

Fiber  Transport  Services. 

The  HP  software  license  that  allows  multiple  E_Ports  on  a  switch,  making  it  possible  to  create 
multiple  ISL  links. 


full  fabric  citizenship  A  loop  device  that  has  an  entry  in  the  Simple  Name  Server, 
full  duplex 


Fx_Porf 
G_Port 

gateway 

GBIC 

Gb/s 

GB/sec 

GLM 

GMT 
GUI 

HA 

half  duplex 

hard  address 

Hardware 
Translative  Mode 

HBA 


A  mode  of  communication  that  allows  the  same  port  to  simultaneously  transmit  and  receive 
frames.  See  also  half  duplex. 

A  fabric  port  that  can  operate  as  either  an  FPort  or  FLPort.  See  also  FPort,  FLPort. 

Generic  port.  A  port  that  can  operate  as  either  an  E  Port  or  an  F  Port.  A  port  is  defined  as  a 
G_Port  when  it  is  not  yet  connected  or  has  not  yet  assumed  a  specific  function  in  the  fabric. 

Hardware  that  connects  incompatible  networks  by  providing  translation  for  both  hardware 
and  software.  For  example,  an  ATM  gateway  can  be  used  to  connect  a  Fibre  Channel  link  to 
an  ATM  connection. 

Gigabit  interface  converter.  A  removable  serial  transceiver  module  that  allows  gigabaud 
physical-level  transport  for  Fibre  Channel  and  gigabit  Ethernet. 

Gigabits  per  second  (1,062,500,000  bits/second). 

Gigabytes  per  second  (1,062,500,000  bytes/second). 

Gigabit  Link  Module.  A  semitransparent  transceiver  that  incorporates  serializing/deserializing 
functions. 

Greenwich  Mean  Time.  An  international  time  zone.  Also  known  as  UTC. 

A  graphic  user  interface,  such  as  HP  Advanced  Web  Tools  arbitrated-loop  topology  and  HP 
Fabric  Manager. 

High  availability.  A  set  of  features  in  HP  StorageWorks  switches  that  is  designed  to  provide 
maximum  reliability  and  nondisruptive  replacement  of  key  hardware  and  software  modules. 

A  mode  of  communication  that  allows  a  port  to  either  transmit  or  receive  frames  at  any  time 
except  simultaneously  (with  the  exception  of  link  control  frames,  which  can  be  transmitted  at 
any  time).  See  also  full  duplex. 

The  AL_PA  that  an  NL  Port  attempts  to  acquire  during  loop  initialization. 

A  method  for  achieving  address  translation.  There  are  two  hardware  translative  modes 
available  to  a  QuickLoop  enabled  switch:  Standard  Translative  Mode  and  QuickLoop  Mode. 

Host  bus  adapter.  The  interface  card  between  a  server  or  workstation  bus  and  the  Fibre 
Channel  network. 


HCPLD 


High-capacity  PLD.  Refers  to  both  CPLDs  and  FPGAs. 
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header 

hop  count 
host 

hot  swappable 
HTTP 

hub 

hunt  group 

HW 

IDJD 

idle 

iFCP 
IFL 

in-band 
initiator 


Insistent  Domain  ID 
Mode 

integrated  fabric 


intercabinet 
intermix 
interswitch  link 
IOD 

IP 
I  PI 
IQN 
ISC 


A  Fibre  Channel  frame  has  a  header  and  a  payload.  The  header  contains  control  and 
addressing  information  associated  with  the  frame. 

The  number  of  ISLs  a  frame  must  traverse  to  get  from  its  source  to  its  destination. 

A  computer  system  that  provides  end  users  with  services  like  computation  and  storage  access. 

A  hot  swappable  component  can  be  replaced  under  power. 

Hypertext  Transfer  Protocol.  The  standard  TCP/IP  transfer  protocol  used  on  the  World  Wide 
Web. 

A  Fibre  Channel  wiring  concentrator  that  collapses  a  loop  topology  into  a  physical  star 
topology.  Nodes  are  automatically  added  to  the  loop  when  active  and  removed  when 
inactive. 

A  number  of  N_Ports  registered  as  a  single  AliasJD  so  that  the  fabric  can  route  a  word  to  a 
port  that  is  not  busy. 

Hardware. 

Insistent  domain  ID.  A  parameter  of  the  configure  command  in  the  HP  Fabric  OS. 

Continuous  transmission  of  an  ordered  set  over  a  Fibre  Channel  link  when  no  data  is  being 
transmitted,  to  keep  the  link  active  and  maintain  bit,  byte,  and  word  synchronization. 

Internet  Fibre  Channel  Protocol.  Supports  Fibre  Channel  Layer  4  FCP-Over-TCP/IP.  It  is  a 
gateway-to-gateway  protocol  in  which  TCP/IP  switching  and  routing  components 
enhance/ replace  Fibre  Channel  fabric. 

Interfabric  link.  A  connection  between  a  router  and  an  edge  fabric.  Architecturally,  these  can 
be  of  type  EX_Port-to-E_Port  or  EX_Port-to-EX_Port. 

Transmission  of  management  protocol  over  the  Fibre  Channel. 

A  server  or  workstation  on  a  Fibre  Channel  network  that  initiates  communications  with  storage 
devices.  See  also  target. 

Sets  the  domain  ID  of  a  switch  as  insistent,  so  that  it  remains  the  same  over  reboots,  power 
cycles,  failovers,  and  fabric  reconfigurations.  This  mode  is  required  to  support  FICON®  traffic. 

The  fabric  created  by  an  HP  StorageWorks  SAN  Switch  Integrated/64,  consisting  of  six  HP 
StorageWorks  1  GB  switches  cabled  together  and  configured  to  handle  traffic  seamlessly  as  a 
group. 

A  specification  for  copper  cabling  that  allows  up  to  33-meter  distances  between  cabinets. 
Allows  any  unused  bandwidth  in  a  Class  1  connection. 

See  ISL. 

In-order  delivery.  A  parameter  that,  when  set,  guarantees  that  frames  are  either  delivered  in 
order  or  dropped. 

Internet  Protocol.  The  addressing  part  of  TCP. 
Intelligent  Peripheral  Interface. 
iSCSI  qualified  name. 
Internet  Software  Consortium. 
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iSCSI  Internet  Small  Computer  Systems  Interface.  A  protocol  that  defines  the  processes  for 

transferring  block  storage  applications  over  TCP/IP  networks  by  encapsulating  SCSI 
commands  into  TCP  and  transporting  them  over  the  network  via  IP. 

iSCSI  Gateway  The  HP  multiprotocol  SAN  routing  service  that  maps  the  FCP  protocol  to  the  IP  transport.  This 
Service  service  projects  iSCSI  hosts  onto  the  backbone  fabric  of  a  gateway  switch. 

ISL  Interswitch  link.  A  Fibre  Channel  link  from  the  E_Port  of  one  switch  to  the  E_Port  of  another.  See 

also  cascade,  EPort. 

ISL  oversub-scription  The  ratio  of  the  number  of  free  ports  (non-ISL)  to  the  number  of  ISLs  on  a  switch, 
ratio 

isolated  E_Port         An  E_Port  that  is  online  but  not  operational  due  to  overlapping  domain  IDs  or  nonidentical 
parameters  (such  as  E  D  TOVs).  See  also  E  Port. 

ISP  Internet  service  provider. 

IU  Information  unit.  A  set  of  information  as  defined  by  either  an  upper-level  process  protocol 

definition  or  upper-level  protocol  mapping. 

JBOD  (Just  a  bunch  of  disks)  Indicates  a  number  of  disks  connected  in  a  single  chassis  to  one  or 

more  controllers.  See  also  RAID. 

jitter  A  deviation  in  timing  for  a  bit  stream  as  it  flows  through  a  physical  medium. 

K28.5  A  special  1 0-bit  character  used  to  indicate  the  beginning  of  a  transmission  word  that  performs 

Fibre  Channel  control  and  signaling  functions.  The  first  seven  bits  of  the  character  are  the 
comma  pattern.  See  also  comma. 

key  A  string  of  data  (usually  a  numeric  value)  shared  between  two  entities  and  used  to  control  a 

cryptographic  algorithm.  Usually  selected  from  a  large  pool  of  possible  keys  to  make 
unauthorized  identification  of  the  key  difficult.  See  also  key  pair. 

key  pair  In  public  key  cryptography,  a  pair  of  keys  consisting  of  an  entity's  public  and  private  key.  The 

public  key  can  be  publicized,  but  the  private  key  must  be  kept  secret.  See  also  public  key 
cryptography. 

L_Port  Loop  port.  A  node  port  (NL  Port)  or  fabric  port  (FL  Port)  that  has  arbitrated-loop  capabilities. 

An  L  Port  can  be  in  either  Fabric  Mode  or  Loop  Mode. 

LAN  Local  area  network.  A  network  in  which  transmissions  typically  take  place  over  fewer  than  5 

kilometers  (3.4  miles). 

latency  The  time  required  to  transmit  a  frame.  Together,  latency  and  bandwidth  define  the  speed  and 

capacity  of  a  link  or  system. 

LED  Light-emitting  diode.  Used  to  indicate  the  status  of  elements  on  a  switch. 

LIFA  Loop-initialization  fabric-assigned  frame.  Contains  a  bitmap  of  all  fabric-assigned  AL_PAs  and 

is  the  first  frame  transmitted  in  the  loop  initialization  process  after  a  temporary  loop  master  has 
been  selected. 

LIHA  Loop-initialization  hard-assigned  frame.  A  hard-assigned  AL_PA  that  is  indicated  by  a  bit  set 

and  is  the  third  frame  transmitted  in  the  loop  initialization  process  after  a  temporary  loop 
master  has  been  selected. 

LILP  Loop-initialization  loop-position  frame.  The  final  frame  transmitted  in  a  loop  initialization 

process.  A  returned  LIRP  contains  an  accumulation  of  all  of  the  AL  PA  position  maps.  This 
allows  loop  members  to  determine  their  relative  loop  position.  This  is  an  optional  frame  and  is 
not  transmitted  unless  the  LIRP  is  also  transmitted. 
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Link  Services 
LIP 

LI  PA 

LIRP 

LISA 

LISM 

LMJOV 

login  server 
Loom 

loop  circuit 
loop  failure 

LoopJD 

loop  initialization 
Loop  Mode 

looplet 
LPB 

LPE 

LPSM 


LR 


A  protocol  for  link-related  actions. 

Loop  initialization  primitive.  The  signal  used  to  begin  initialization  in  a  loop.  Indicates  either 
loop  failure  or  node  resetting. 

Loop-initialization  previously  assigned.  The  device  marks  a  bit  in  the  bitmap  if  it  did  not  log  in 
with  the  fabric  in  a  previous  loop  initialization. 

Loop-initialization  report  position  frame.  The  first  frame  transmitted  in  the  loop  initialization 
process  after  all  L  Ports  have  selected  an  ALPA.  The  LIRP  gets  transmitted  around  the  loop  so 
all  L_Ports  can  report  their  relative  physical  position.  This  is  an  optional  frame. 

Loop-initialization  soft-assigned  frame.  The  fourth  frame  transmitted  in  the  loop  initialization 
process  after  a  temporary  loop  master  has  been  selected.  L_Ports  that  have  not  selected  an 
AL_PA  in  a  LIFA,  LIPA,  or  LIHA  frame  select  their  AL  PA  here. 

Loop-initialization  select  master  frame.  The  first  frame  transmitted  in  the  initialization  process 
when  L_Ports  select  an  AL_PA.  LISM  is  used  to  select  a  temporary  loop  master  or  the  L_Port  that 
will  subsequently  start  transmission  of  the  LIFA,  LIPA,  LIHA,  LISA,  LIRP,  or  LILP  frames. 

Loop  master  timeout  value.  The  minimum  time  that  the  loop  master  waits  for  a  loop 
initialization  sequence  to  return. 

The  unit  that  responds  to  login  requests. 

The  code  name  given  to  the  second-generation  HP  Fabric  ASIC.  This  is  the  ASIC  used  in  the 
StorageWorks  1  GB  switches. 

A  temporary  bidirectional  communication  path  established  between  L_Ports. 

Loss  of  signal  within  a  loop  for  any  period  of  time,  or  loss  of  synchronization  for  longer  than 
the  timeout  value. 

A  hexadecimal  value  representing  one  of  the  1  27  possible  AL_PA  values  in  an  arbitrated  loop. 

The  logical  procedure  used  by  an  L_Port  to  discover  its  environment.  Can  be  used  to  assign 
AL_PA  addresses,  detect  loop  failure,  or  reset  a  node. 

One  of  two  possible  modes  for  an  L_Port,  in  which  the  L_Port  is  in  an  arbitrated  loop,  using 
loop  protocol.  An  L_Port  in  Loop  Mode  can  also  be  in  Participating  Mode  or  Nonparticipating 
Mode. 

A  set  of  devices  connected  in  a  loop  to  a  port  that  is  a  member  of  another  loop. 

Loop  port  bypass.  A  primitive  sequence  transmitted  by  an  L_Port  to  bypass  one  or  all  L_Ports  to 
which  it  is  directed.  It  is  used  only  in  arbitrated  loops. 

Loop  port  enable.  A  primitive  sequence  transmitted  by  an  L_Port  to  enable  one  or  all  L_Ports 
that  have  been  bypassed  with  the  LPB.  It  is  used  only  in  arbitrated  loops. 

Loop  Port  State  Machine.  Logic  that  monitors  and  performs  the  tasks  required  for  initialization 
and  access  to  the  loop.  It  is  maintained  by  an  L_Port  to  track  behavior  through  different  phases 
of  loop  operations.  Alternatively,  the  logical  entity  that  performs  arbitrated-loop  protocols  and 
defines  the  behavior  of  L_Ports  when  they  require  access  to  an  arbitrated  loop. 

Link  reset.  A  primitive  sequence  used  during  link  initialization  between  two  N_Ports  in 
point-to-point  topology  or  an  N_Port  and  an  F_Port  in  fabric  topology.  The  expected  response 
is  an  LRR. 
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Link  reset  response.  A  primitive  sequence  during  link  initialization  between  two  N_Ports  in 
point-to-point  topology  or  an  NPort  and  an  F  Port  in  fabric  topology.  It  is  sent  in  response  to 
an  LR  and  expects  a  response  of  Idle. 

Logical  storage  area  network.  An  LSAN  enables  device  and  storage  connectivity  that  spans 
two  or  more  fabrics.  The  path  between  devices  in  an  LSAN  can  be  local  to  a  fabric  or  cross 
one  or  more  FC  routers  and  one  or  more  backbone  fabrics. 

The  mechanism  by  which  LSANs  are  administered.  An  FC  router  attached  to  two  fabrics  will 
"listen"  for  the  creation  of  matching  LSAN  zones  on  both  fabrics.  If  this  occurs,  it  will  create 
phantom  domains  and  FC-NAT  entries  as  appropriate,  and  insert  entries  for  them  into  the 
name  servers  on  the  fabrics.  LSAN  zones  are  compatible  with  all  standard  zoning 
mechanisms. 

Long  wavelength.  A  type  of  fiber  optic  cabling  that  is  based  on  1 300-mm  lasers  and  supports 
link  speeds  of  1 .0625  Gb/sec.  Can  also  see  the  type  of  GBIC  or  SFP.  See  also  SWL. 

Memory  allocation.  Usually  relates  to  buffer  credits. 

Metropolitan  area  network. 

Megabytes  per  second. 

Megabits  per  second. 

The  collection  of  all  devices,  switches,  edge  and  backbone  fabrics,  LSANs,  and  FC  routers  that 
make  up  a  physically  connected  but  logically  partitioned  storage  network.  LSANs  span 
between  edge  fabrics  using  FC  routers.  In  a  data  network,  this  would  simply  be  called  the 
network.  However,  an  additional  term  is  required  to  specify  the  difference  between  a 
single-fabric  network  (SAN),  a  multifabric  network  without  cross-fabric  connectivity 
(dual-redundant  fabric  SAN),  and  a  multifabric  network  with  connectivity  (meta-SAN). 

A  relative  value  assigned  to  a  route  to  aid  in  calculating  the  shortest  path  (1000  @  1  Gb/s, 
500  @  2  Gb/s). 

Media  interface  adapter.  A  device  that  converts  optical  connections  to  copper  ones,  and 
vice-versa. 

Management  Information  Base.  An  SNMP  structure  to  help  with  device  management, 
providing  configuration  and  device  information. 

Multimode  fiber.  See  SWL. 

Managed  Object  Format  file. 

A  platform  running  the  HP  Fibre  Channel  Routing  Service  or  FC-to-FC  routing  (for  instance,  the 
StorageWorks  MP  Router)  that  enables  two  or  more  fabrics  to  share  resources  (such  hosts  or 
storage  devices)  without  merging  those  fabrics.  The  platform  could  simultaneously  be  used  as 
an  MP  router  and  as  an  FCIP  tunnel  or  iSCSI  gateway. 

Mark  primitive  signal.  Used  only  in  arbitrated  loop,  MRK  is  transmitted  by  an  L_Port  for 
synchronization  and  is  vendor  specific. 

Management  Server.  The  Management  Server  allows  a  storage  area  network  (SAN) 
management  application  to  retrieve  information  and  administer  the  fabric  and  interconnected 
elements,  such  as  switches,  servers,  and  storage  devices.  The  MS  is  located  at  the  Fibre 
Channel  well-known  address  FFFFFAh. 

Management  Server  daemon.  Monitors  the  MS.  Includes  the  Fabric  Configuration  Service  and 
the  Unzoned  Name  Server. 


MSRS 

MTBF 
multicast 

multimode 
N_Port 

Name  Server 


NAS 

NDMP 

NL_Port 

node 

node  count 

node  name 

Nonparticipating 
Mode 

NOS 

NR_Port 
NS 

NSCAM 

Nx_Port 
OFC 

OLS 
ON 
OPN 


Multiprotocol  SAN  Routing  Services.  An  optionally  licensed  software  bundle  available  on 
certain  HP  platforms,  such  as  the  HP  StorageWorks  MP  Router,  that  includes  the  Fibre  Channel 
Routing  Service,  the  iSCSI  Gateway  Service,  and  the  FCIP  Tunneling  Service. 

Mean  time  between  failures.  An  expression  of  time,  indicating  the  longevity  of  a  device. 

The  transmission  of  data  from  a  single  source  to  multiple  specified  N  Ports  (as  opposed  to  all 
the  ports  on  the  network).  See  also  broadcast,  unicast. 

A  fiber  optic  cabling  specification  that  allows  up  to  500  meters  between  devices. 

Node  port.  A  port  on  a  node  that  can  connect  to  a  Fibre  Channel  port  or  to  another  N_Port  in 
a  point-to-point  connection.  See  also  NL_Port,  Nx_Port. 

Simple  Name  Server  (SNS).  A  switch  service  that  stores  names,  addresses,  and  attributes  for 
up  to  15  minutes  and  provides  them  as  required  to  other  devices  in  the  fabric.  SNS  is  defined 
by  Fibre  Channel  standards  and  exists  at  a  well-known  address.  Also  referred  to  as  directory 
service. 

Network-attached  storage.  A  disk  array  connected  to  a  controller  that  gives  access  via  a  LAN. 

Network  Data  Management  Protocol.  Used  for  tape  backup  without  using  server  resources. 

Node  loop  port.  A  node  port  that  has  arbitrated-loop  capabilities.  Used  to  connect  an 
equipment  port  to  the  fabric  in  a  loop  configuration  through  an  FL_Port.  See  also  N_Port, 
Nx_Port. 

A  Fibre  Channel  device  that  contains  an  N_Port  or  NL_Port. 
The  number  of  nodes  attached  to  a  fabric. 

The  unique  identifier  for  a  node,  communicated  during  login  and  port  discovery. 

A  mode  in  which  an  L_Port  in  a  loop  is  inactive  and  cannot  arbitrate  or  send  frames  but  can 
retransmit  received  transmissions.  This  mode  is  entered  if  there  are  more  than  1  27  devices  in  a 
loop  and  an  AL_PA  cannot  be  acquired.  See  also  L_Port,  Participating  Mode. 

Not  operational.  The  NOS  primitive  sequence  is  transmitted  to  indicate  that  the  FC_Port 
transmitting  the  NOS  has  detected  a  link  failure  or  is  offline,  waiting  for  the  offline  sequence 
(OLS)  to  be  received. 

A  normal  E  Port  used  to  connect  an  FC  router  to  a  backbone  fabric. 

Name  Server.  The  service  provided  by  a  fabric  switch  that  stores  names,  addresses,  and 
attributes  related  to  Fibre  Channel  objects.  Can  cache  information  for  up  to  15  minutes.  Also 
known  as  Simple  Name  Server  or  as  a  directory  service.  See  also  Simple  Name  Server  (SNS). 

Name  Server  Cache  Manager.  Updates  the  Name  Server  (NS)  databases  across  switches  as 
a  background  task. 

A  node  port  that  can  operate  as  either  an  N  Port  or  NL  Port. 

Open  fiber  control.  A  method  used  to  enable  and  disable  laser  signaling  for  higher-intensity 
laser  transceivers. 

Primitive  sequence  offline. 

Offline  notification.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

Open  primitive  signal.  Applies  only  to  arbitrated  loop;  sent  by  an  L_Port  that  has  won  the 
arbitration  process  to  open  communication  with  one  or  more  ports  on  the  loop. 
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ordered  set 


originator 
out-of-band 

oversub-scription 

OXJD 
PAL 

parallel 

Participating  Mode 
passive  copper 
path  selection 
payload 

PBC 
PCM 

Performance 
Monitoring 

persistent  error  log 

phantom  address 

phantom  device 

phantom  domain 
PID 


A  transmission  word  that  uses  8b/10b  mapping  and  begins  with  the  K28.5  character. 
Ordered  sets  occur  outside  of  frames  and  include  the  following  items: 

Frame  delimiters— Mark  frame  boundaries  and  describe  frame  contents. 

•  Primitive  signals— Indicate  events. 

•  Primitive  sequences— Indicate  or  initiate  port  states. 

Ordered  sets  are  used  to  differentiate  Fibre  Channel  control  information  from  data  frames  and 
to  manage  frame  transport. 

The  Nx  Port  that  originated  an  exchange. 

Transmission  of  management  protocol  outside  of  the  Fibre  Channel  network,  usually  over 
Ethernet. 

A  situation  in  which  more  nodes  could  potentially  contend  for  a  resource  than  the  resource 
could  simultaneously  support  (typically  an  ISL).  Oversubscription  could  be  a  desirable  attribute 
in  fabric  topology,  as  long  as  it  does  not  produce  unacceptable  levels  of  congestion. 

Originator  ID  or  exchange  ID.  Refers  to  the  exchange  ID  assigned  by  the  originator  port. 

Programmable  Array  Logic.  A  relatively  small  FPD. 

The  simultaneous  transmission  of  data  bits  over  multiple  lines. 

A  mode  in  which  an  L_Port  in  a  loop  has  a  valid  AL_PA  and  can  arbitrate,  send  frames,  and 
retransmit  received  transmissions.  See  also  L  Port,  Nonparticipating  Mode. 

A  low-cost  copper  Fibre  Channel  connection,  allowing  distances  up  to  13  meters  between 
devices. 

The  selection  of  a  transmission  path  through  the  fabric.  HP  switches  use  the  FSPF  protocol.  See 
also  FSPF. 

A  Fibre  Channel  frame  has  a  header  and  a  payload.  The  payload  contains  the  information 
being  transported  by  the  frame;  it  is  determined  by  the  higher-level  service  or  FC_4  upper-level 
protocol.  There  are  many  different  payload  formats,  based  on  protocol. 

Port  bypass  circuit.  A  circuit  in  hubs  or  a  disk  enclosure  to  open  or  close  a  loop  to  add  or 
remove  nodes. 

Pulse-code  modulation.  A  standard  method  of  encoding  analog  audio  signals  in  digital  form. 

An  HP  StorageWorks  switch  feature  that  monitors  port  traffic  and  includes  frame  counters, 
SCSI  read  monitors,  SCSI  write  monitors,  and  other  types  of  monitors. 

Error  messages  of  a  high  enough  level  (by  default,  Panic  or  Critical)  are  saved  to  flash  memory 
on  the  switch  instead  of  to  RAM.  These  messages  are  saved  over  reboots  and  power  cycles, 
constituting  the  persistent  error  log.  Note  that  each  CP  on  a  StorageWorks  2/64  has  its  own 
unique  persistent  error  log. 

An  AL_PA  value  that  is  assigned  to  a  device  that  is  not  physically  in  the  loop.  Also  known  as 
phantom  AL_PA. 

A  device  that  is  not  physically  in  an  arbitrated-loop  but  is  logically  included  through  the  use  of 
a  phantom  address. 

See  xlate  domain. 

Port  identifier. 
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PKI 

PKI  certification 
utility 

PLDA 

PLOGI 

point-to-point 
port 

port  address 

port  card 

port  log 

port  log  dump 

port  name 
port  swapping 

portname 

POST 
PPP 

primary  FCS  switch 

primitive  sequence 

primitive  signals 

principal  switch 
private  device 

private  key 


Public  key  infrastructure.  An  infrastructure  that  is  based  on  public  key  cryptography  and  CA 
(certificate  authority)  and  that  uses  digital  certificates.  See  also  CA,  digital  certificate,  public 
key  cryptography. 

Public  key  infrastructure  certification  utility.  A  utility  that  makes  it  possible  to  collect  certificate 
requests  from  switches  and  to  load  certificates  to  switches.  See  also  digital  certificate,  PKI. 

Private  loop  direct-attached.  A  technical  report  specifying  a  logical  loop. 

Port  login.  The  port-to-port  login  process  by  which  initiators  establish  sessions  with  targets.  See 
also  FLOGI. 

A  Fibre  Channel  topology  that  employs  direct  links  between  each  pair  of  communicating 
entities.  See  also  topology. 

In  an  HP  StorageWorks  switch  environment,  an  SFP  or  GBIC  receptacle  on  a  switch  to  which 
an  optic  cable  for  another  device  is  attached. 

In  Fibre  Channel  technology,  the  port  address  is  defined  in  hexadecimal.  In  the  HP  Fabric  OS, 
a  port  address  can  be  defined  by  a  domain  and  port  number  combination  or  by  area  number. 
In  an  ESCON  Director,  an  address  used  to  specify  port  connectivity  parameters  and  to  assign 
link  addresses  for  attached  channels  and  control  units. 

A  hardware  component  that  provides  a  platform  for  field-replaceable,  hot  swappable  ports. 
A  record  of  all  activity  on  a  switch,  kept  in  volatile  memory. 

A  view  of  what  happens  on  a  switch,  from  the  switch's  point  of  view.  The  portLogDump 
command  is  used  to  read  the  port  log. 

A  user-defined  alphanumeric  name  for  a  port. 

Port  swapping  is  the  ability  to  redirect  a  failed  port  to  another  port.  This  feature  is  available  in 
Fabric  OS  v4.1 .0  and  higher. 

The  unique  identifier  assigned  to  a  Fibre  Channel  port.  Communicated  during  login  and  port 
discovery. 

Power-on  self-test.  A  series  of  tests  run  by  a  switch  after  it  is  turned  on. 
Point-to-Point  Protocol. 

Relates  to  the  HP  Secure  Fabric  OS  feature.  The  primary  fabric  configuration  server  switch 
actively  manages  security  and  configurations  for  all  switches  in  the  fabric.  See  also  backbone 
fabric,  FCS  switch. 

An  ordered  set  that  is  transmitted  repeatedly  and  continuously.  Primitive  sequences  are 
transmitted  to  indicate  specific  conditions  within  or  conditions  encountered  by  the  receiver 
logic  of  an  FC_Port.  See  OLS  and  NOS. 

An  ordered  set  that  indicates  actions  or  events  and  requires  just  one  occurrence  to  trigger  a 
response.  IDLE  and  RRDY  are  used  in  all  three  topologies:  ARB,  OPN,  and  CLS.  MRK  is  used 
in  arbitrated  loop. 

The  first  switch  to  boot  up  in  a  fabric.  Ensures  unique  domain  IDs  among  roles. 

A  device  that  supports  arbitrated-loop  protocol  and  can  interpret  8-bit  addresses  but  cannot 
log  in  to  the  fabric. 

The  secret  half  of  a  key  pair.  See  also  key,  key  pair. 
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private  loop 
private  loop  device 

private  NL  Port 

protocol 

pstate 
PSU 

public  device 


public  key 

public  key 
cryptography 


public  loop 

public  NL_Port 

QLA 

QLFA 

QoS 

quad 

queue 

QuickLoop 

QuickLoop  Mode 

R_A_TOV 

RCTL 

RRDY 

R_T_TOV 

radius 


An  arbitrated  loop  that  does  not  include  a  participating  FL_Port. 

A  device  that  supports  a  loop  and  can  understand  8-bit  addresses  but  does  not  log  in  to  the 
fabric. 

An  NL_Port  that  communicates  only  with  other  private  NL_Ports  in  the  same  loop  and  does  not 
log  in  to  the  fabric. 

A  defined  method  and  set  of  standards  for  communication.  Determines  the  type  of 
error-checking,  the  data-compression  method,  how  sending  devices  indicate  an  end  of 
message,  and  how  receiving  devices  indicate  receipt  of  a  message. 

Port  State  Machine. 

Power  supply  unit. 

A  device  that  supports  arbitrated-loop  protocol,  can  interpret  8-bit  addresses,  and  can  log  in 
to  the  fabric. 

The  public  half  of  a  key  pair.  See  also  key,  key  pair. 

A  type  of  cryptography  that  uses  a  key  pair,  with  the  two  keys  in  the  pair  called  at  different 
points  in  the  algorithm.  The  sender  uses  the  recipient's  public  key  to  encrypt  the  message,  and 
the  recipient  uses  the  recipient's  private  key  to  decrypt  it.  See  also  key  pair,  "PKI". 

An  arbitrated  loop  that  includes  a  participating  FL_Port  and  can  contain  both  public  and 
private  NL  Ports. 

An  NL_Port  that  logs  in  to  the  fabric,  can  function  within  either  a  public  or  a  private  loop,  and 
can  communicate  with  either  private  or  public  NL_Ports. 

A  type  of  Fibre  Channel  controller. 

QuickLoop  Fabric  Assist.  Arbitrated-loop  technology. 

Quality  of  service. 

A  group  of  four  adjacent  ports  that  share  a  common  pool  of  frame  buffers. 

A  mechanism  for  each  AL_PA  address  that  allows  for  collecting  frames  prior  to  sending  them 
to  the  loop. 

An  HP  software  product  that  allows  multiple  ports  on  a  switch  to  create  a  logical  loop. 
Devices  connected  via  QuickLoop  appear  to  each  other  as  if  they  are  on  the  same  arbitrated 
loop. 

Allows  initiator  devices  to  communicate  with  private  or  public  devices  that  are  not  in  the  same 
loop. 

Resource  allocation  timeout  value.  The  maximum  time  a  frame  can  be  delayed  in  the  fabric 
and  still  be  delivered.  See  also  E_D_TOV,  RR_TOV. 

Route  control.  The  first  8  bits  of  the  header,  which  defines  the  type  of  frame  and  its  contents. 

Receiver  ready.  A  primitive  signal  indicating  that  the  port  is  ready  to  receive  a  frame. 

Receiver  transmitter  timeout  value,  used  by  receiver  logic  to  detect  loss  of  synchronization 
between  transmitters  and  receivers. 

The  greatest  distance  between  any  edge  switch  and  the  center  of  a  fabric.  A  low-radius 
network  is  better  than  a  high-radius  network. 
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RAID 

RAIT 
RCS 

RCS_SFC 
receiver 
redundancy 
remote  switch 

repeater 
request  rate 
resilience 

resilient  core/edge 
topology 

res ponder 

retimer 

return  loss 

RLS 
route 

routing 
RRJOV 

RSCN 


RTWR 

running  disparity 

RW 
RX 

RX  ID 


Redundant  array  of  independent  disks.  A  collection  of  disk  drives  that  appear  as  a  single 
volume  to  the  server  and  are  fault  tolerant  through  mirroring  or  parity  checking.  See  also 

JBOD. 

Redundant  array  of  independent  tapes. 

Reliable  Commit  Service.  Refers  to  HP-specific  ILS  command  code. 
RCS  Stage  Fabric  Config.  Refers  to  HP-specific  ILS  command  code. 
A  device  that  performs  detection  and  signal  processing. 

Having  multiple  occurrences  of  a  component  to  maintain  high  availability  (HA). 

An  optional  product  for  long-distance  fabrics,  requiring  a  Fibre  Channel-to-ATM  or  SONET 
gateway. 

A  circuit  that  uses  a  recovered  clock  to  regenerate  and  transmit  an  outbound  signal. 
The  rate  at  which  requests  arrive  at  a  servicing  entity. 

A  fabric's  ability  to  adapt  to  or  tolerate  a  failure  of  a  component  within  the  fabric. 

Two  or  more  switches  acting  as  a  core  to  interconnect  multiple  edge  switches.  Nodes  attach  to 
the  edge  switches. 

The  N_Port  with  which  an  exchange  originator  attempts  to  communicate. 

A  circuit  that  uses  an  independent  clock  to  generate  outbound  signals. 

The  ratio  (expressed  in  dB)  of  incident  power  to  reflected  power,  when  a  component  or 
assembly  is  introduced  into  a  link  or  system.  Can  see  optical  power  or  to  electrical  power  in 
a  specified  frequency  range. 

Read  Link  Status. 

As  it  applies  to  a  fabric,  the  communication  path  between  two  switches.  Might  also  apply  to 
the  specific  path  taken  by  an  individual  frame,  from  source  to  destination.  See  also  FSPF. 

The  assignment  of  frames  to  specific  switch  ports,  according  to  frame  destination. 

Resource  recovery  timeout  value.  The  minimum  time  a  target  device  in  a  loop  waits  after  an  LIP 
before  logging  out  an  SCSI  initiator.  See  also  E  D  TOV,  R  A  TOV. 

Registered  state  change  notification.  A  switch  function  that  allows  notification  of  fabric 
changes  to  be  sent  from  the  switch  to  specified  nodes.  The  fabric  controller  issues  RSCN 
requests  to  N_Ports  and  NL_Ports,  but  only  if  they  have  registered  to  be  notified  of  state 
changes  in  other  NPorts  and  NLPorts.  This  registration  is  performed  via  the  State  Change 
Registration  (SCR)  Extended  Link  Service.  An  NPort  or  NLPort  can  issue  an  RSCN  to  the 
fabric  controller  without  having  completed  SCR  with  the  fabric  controller. 

Reliable  transport  with  response.  Might  appear  as  a  task  in  portLogDump  command  output. 

A  binary  parameter  indicating  the  cumulative  disparity  (positive  or  negative)  of  all  previously 
issued  transmission  characters. 

Read/write.  Refers  to  access  rights. 

Receiving  frames. 

Responder  exchange  identifier.  A  2-byte  field  in  the  frame  header  that  can  be  used  by  the 
responder  of  the  exchange  to  identify  frames  as  being  part  of  a  particular  exchange. 
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S_ID 
SAN 

SAN  architecture 

SAN  port  count 
scalability 

SCC 


SCN 

SCSI 

SCSI-2 
SCSI-3 
SDRAM 
sectelnet 
Secure  Fabric  OS 
security  policy 

SEQJD 

sequence 
sequence  initiator 
sequence  recipient 

serial 
server 
service  rate 
SES 

SFF 
SFP 

SFP  cable 


Source  ID.  Refers  to  the  native  port  address  (24  bit  address). 

Storage  area  network.  A  network  of  systems  and  storage  devices  that  communicate  using  Fibre 
Channel  protocols.  See  also  fabric. 

The  overall  design  of  a  storage  network  solution,  which  includes  one  or  more  related  fabrics, 
each  of  which  has  a  topology. 

The  number  of  ports  available  for  connection  by  nodes  in  the  entire  SAN. 

One  of  the  properties  of  a  SAN:  the  size  to  which  a  SAN  topology  can  grow  port  and  switch 
counts  with  ease. 

SC  connector.  An  SC  connector  is  a  fiber-optic  cable  connector  that  uses  a  push-pull  latching 
mechanism  similar  to  common  audio  and  video  cables.  For  bidirectional  transmissions,  two 
fiber  cables  and  two  SC  connectors  (dual  SC)  are  generally  used.  SC  is  specified  by  the  TIA 
as  FOCIS-3. 

State  change  notification.  Used  for  internal  state  change  notifications,  not  external  changes. 
This  is  the  switch  logging  that  the  port  is  online  or  is  an  Fx_Port,  not  what  is  sent  from  the 
switch  to  the  Nx_Ports. 

Small  Computer  Systems  Interface.  A  parallel  bus  architecture  and  a  protocol  for  transmitting 
large  data  blocks  to  a  distance  of  1 5  to  25  meters. 

An  updated  version  of  the  SCSI  bus  architecture. 

An  SCSI  standard  that  defines  transmission  of  SCSI  protocol  data  over  different  kinds  of  links. 
The  main  memory  for  a  switch. 

A  protocol  similar  to  telnet  but  with  encrypted  passwords  for  increased  security. 

An  optionally  licensed  HP  feature  that  provides  advanced,  centralized  security  for  a  fabric. 

Rules  that  determine  how  security  is  implemented  in  a  fabric.  Security  policies  can  be 
customized  through  HP  Secure  Fabric  OS  or  HP  Fabric  Manager. 

Sequence  identifier.  A  1-byte  field  in  the  frame  header  change  to  identify  the  frames  as  being 
part  of  a  particular  exchange  sequence  between  a  pair  of  ports. 

A  group  of  related  frames  transmitted  in  the  same  direction  between  two  NPorts. 

The  N_Port  that  begins  a  new  sequence  and  transmits  frames  to  another  NPort. 

Serializing/deserializing  circuitry.  A  circuit  that  converts  a  serial  bit  stream  into  parallel 
characters,  and  vice-versa. 

The  transmission  of  data  bits  in  sequential  order  over  a  single  line. 

A  computer  that  processes  end-user  applications  or  requests. 

The  rate  at  which  an  entity  can  service  requests.  See  also  request  rate. 

SCSI  Enclosure  Services.  A  subset  of  the  SCSI  protocol  used  to  monitor  temperature,  power, 
and  fan  status  for  enclosed  devices. 

Small-form-factor.  An  industry  term  for  a  smaller  transceiver.  See  SFP. 

Small-form-factor  pluggable.  A  transceiver  used  on  2  GB/sec  switches  that  replaces  the  GBIC. 
A  cable  specifically  designed  for  use  with  an  SFP.  Not  compatible  with  GBICs. 
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SI 


Sequence  initiative. 


Simple  Name  Server 
(SNS) 


Single  CP  Mode 

Single  Mode 
S-Link  Service 

SLP 
SMDS 

SMF 
SMI 

SMI 
SMI-S 
SNA/SDLC 
SNMP 


SNS 
SOF 

soft  zone 


SolP 
SONET 

special  character 


A  switch  service  that  stores  names,  addresses,  and  attributes  for  up  to  15  minutes  and 
provides  them  as  required  to  other  devices  in  the  fabric.  SNS  is  defined  by  Fibre  Channel 
standards  and  exists  at  a  well-known  address.  Also  referred  to  as  directory  service  or  name 
server. 

The  -s  option  of  the  f  irmwareDownload  command.  Using  f  irmwareDownload  -s 
enables  Single  CP  Mode.  In  the  StorageWorks  2/64,  Single  CP  Mode  enables  a  user  to 
upgrade  a  single  CP  and  to  select  full  install,  autoreboot,  and  autocommit. 

The  fiber-optic  cabling  standard  for  devices  up  to  10  km  apart. 

Facilities  used  between  an  N_Port  and  the  fabric,  or  between  two  N_Ports,  for  login, 
sequence/exchange  management,  and  maintaining  connections. 

Service  Location  Protocol. 

Switched  Multimegabit  Data  Service.  A  good  protocol  for  interconnecting  LANs;  however, 
SMDS  has  less  error-checking  capability  than  Frame  Relay. 

Single-mode  fiber.  See  LWL. 

Storage  Management  Initiative.  A  broad-based  initiative  sponsored  by  the  Storage 
Networking  Industry  Association  (SNIA)  to  standardize  all  aspects  of  storage  management  for 
multivendor  storage  networking  products. 

Structure  of  management  information.  A  notation  for  setting  or  retrieving  SNMP  management 
variables. 

Storage  Management  Initiative  Specification.  Defines  the  interface  that  allows  storage 
management  systems  to  manage  and  monitor  storage  area  network  (SAN)  resources. 

Systems  Network  Architecture/Synchronous  Data  Link  Control.  A  structure  for  transferring  data 
among  a  variety  of  computing  platforms. 

Simple  Network  Management  Protocol.  An  Internet  management  protocol  that  uses  either  IP 
for  network-level  functions  and  UDP  for  trans  port- 1  eve  I  functions,  or  TCP/IP  for  both.  Can  be 
made  available  over  other  protocols,  such  as  UDP/IP,  because  it  does  not  rely  on  the 
underlying  communication  protocols.  See  also  community  (SNMP). 

Simple  Name  Server. 

Start  of  frame.  A  group  of  ordered  sets  that  marks  the  beginning  of  a  frame  and  indicates  the 
class  of  service  the  frame  will  use. 

A  zone  consisting  of  zone  members  that  are  made  visible  to  each  other  through  client  service 
requests.  Typically,  soft  zones  contain  zone  members  that  are  visible  to  devices  using  Name 
Server  exposure  of  zone  members.  The  fabric  does  not  enforce  a  soft  zone.  Note  that 
well-known  addresses  are  implicitly  included  in  every  zone. 

SCSI-over-IP. 

Synchronous  optical  network.  A  standard  for  optical  networks  that  provides  building  blocks 
and  flexible  payload  mappings. 

A  10-bit  character  that  does  not  have  a  corresponding  8-bit  value  but  is  still  considered  valid. 
The  special  character  is  used  to  indicate  that  a  particular  transmission  word  is  an  ordered  set. 
This  is  the  only  type  of  character  to  have  five  1  s  or  0s  in  a  row. 


SPLD 


Simple  PLD.  Usually,  either  a  PLA  or  PAL. 
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SPOF 
SSH 

Standard  Translative 
Mode 

stealth  mode 
striping 

switch 

switch  name 

switch  port 

switch-to-switch 
authentication 

SWL 

syslog 
T10 
Til 

tachyon 
target 
TC 

TCP/IP 
telnet 

tenancy 

throughput 

tiering 

Time  Server 
topology 


Single  point  of  failure.  Any  component  in  a  SAN  whose  malfunction  could  bring  down  the 
entire  SAN. 

Secure  shell.  Used  starting  in  HP  Fabric  OS  v4.1  to  support  encrypted  telnet  sessions  to  the 
switch.  SSH  encrypts  all  messages,  including  the  client  sending  the  password  at  login. 

Allows  public  devices  to  communicate  with  private  devices  that  are  directly  connected  to  the 
fabric. 

A  method  used  in  some  switches  to  simulate  HP  switches  using  QuickLoop. 

A  RAID  technique  for  writing  a  file  to  multiple  disks  on  a  block-by-block  basis,  with  or  without 
parity. 

A  fabric  device  providing  bandwidth  and  high-speed  routing  of  data  via  link-level  addressing. 
The  arbitrary  name  assigned  to  a  switch. 

A  port  on  a  switch.  Switch  ports  can  be  E  Ports,  F  Ports,  or  FL  Ports. 

The  process  of  authenticating  both  switches  in  a  switch-to-switch  connection  using  digital 
certificates.  See  also  authentication,  digital  certificate. 

Short  wavelength.  A  type  of  fiber  optic  cabling  that  is  based  on  850  mm  lasers  and  supports 
1 .0625  GB/sec.  link  speeds.  Can  also  see  the  type  of  GBIC  or  SFP.  See  also  LWL. 

Syslog  daemon.  Used  to  forward  error  messages. 

A  standards  committee  chartered  with  creating  standards  for  SCSI. 

A  standards  committee  chartered  with  creating  standards  for  Fibre  Channel. 

A  chip  that  supports  FC-0  through  FC-2  on  a  single  chip. 

A  storage  device  on  a  Fibre  Channel  network.  See  also  initiator. 

Track  changes. 

Transmission  Control  Protocol  Internet  Protocol. 

A  virtual  terminal  emulation  used  with  TCP/IP.  "Telnet"  is  sometimes  used  as  a  synonym  for  the 
HP  Fabric  OS  CLI. 

The  time  from  when  a  port  wins  arbitration  in  a  loop  until  the  same  port  returns  to  the 
monitoring  state.  Also  referred  to  as  "loop  tenancy." 

The  rate  of  data  flow  achieved  within  a  cable,  link,  or  system.  Usually  measured  in  bps  (bits 
per  second  or  b/sec).  See  also  BB  fabric. 

The  process  of  grouping  particular  SAN  devices  by  function  and  then  attaching  these  devices 
to  particular  switches  or  groups  of  switches  based  on  that  function. 

A  Fibre  Channel  service  that  allows  for  the  management  of  all  timers. 

As  it  applies  to  Fibre  Channel  technology,  the  configuration  of  the  Fibre  Channel  network  and 
the  resulting  communication  paths  allowed.  There  are  three  possible  topologies: 

•  Point  to  point— A  direct  link  between  two  communication  ports. 

•  Switched  fabric— Multiple  N_Ports  linked  to  a  switch  by  F_Ports. 

•  Arbitrated  loop— Multiple  NL_Ports  connected  in  a  loop. 
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TPC 

track  changes 

transceiver 

translate  domain 

Translative  Mode 

transmission 
character 

transmission  word 

trap  (SNMP) 

trunking 

trunking  group 
trunking  ports 
TS 
TTL 

tunneling 
TX 

U_Port 

UDP 
ULP 

ULPJOV 

unicast 

UTC 

WAN 

WANJOV 
watchdog 


Third-party  copy.  A  protocol  for  performing  tape  backups  without  using  server  resources. 

An  HP  Fabric  OS  feature  that  can  be  enabled  to  report  specific  activities  (for  example,  logins, 
logouts,  and  configuration  task  changes).  The  output  from  the  track-changes  feature  is  dumped 
to  the  error  log  for  the  switch. 

A  device  that  converts  one  form  of  signaling  to  another  for  transmission  and  reception;  in  fiber 
optics,  optical  to  electrical. 

See  xlate  domain. 

A  mode  in  which  private  devices  can  communicate  with  public  devices  across  the  fabric. 
A  10-bit  character  encoded  according  to  the  rules  of  the  8b/10b  algorithm. 

A  group  of  four  transmission  characters. 

The  message  sent  by  an  SNMP  agent  to  inform  the  SNMP  management  station  of  a  critical 
error.  See  a/so  SNMP. 

In  Fibre  Channel  technology,  a  feature  that  enables  distribution  of  traffic  over  the  combined 
bandwidth  of  up  to  four  ISLs  between  adjacent  switches,  while  preserving  in-order  delivery. 

A  set  of  up  to  four  trunked  ISLs. 

The  ports  in  a  set  of  trunked  ISLs. 

Time  Server. 

Time-to-live.  The  number  of  seconds  an  entry  exists  in  cache  before  it  expires. 

A  technique  for  enabling  two  networks  to  communicate  when  the  source  and  destination  hosts 
are  both  on  the  same  type  of  network  but  are  connected  by  a  different  type  of  network. 

Transmit. 

Universal  port.  A  switch  port  that  can  operate  as  a  G_Port,  E  Port,  F_Port,  or  FL  Port.  A  port  is 
defined  as  a  U_Port  when  it  is  not  connected  or  has  not  yet  assumed  a  specific  function  in  the 
fabric. 

User  Datagram  Protocol.  A  protocol  that  runs  on  top  of  IP  and  provides  port  multiplexing  for 
upper-level  protocols. 

Upper-level  protocol.  The  protocol  that  runs  on  top  of  Fibre  Channel.  Typical  upper-level 
protocols  are  SCSI,  IP,  HIPPI,  and  I  PI . 

Upper-level  timeout  value.  The  minimum  time  that  an  SCSI  ULP  process  waits  for  SCSI  status 
before  initiating  ULP  recovery. 

The  transmission  of  data  from  a  single  source  to  a  single  destination.  See  also  broadcast, 
multicast. 

Universal  Time  Conversion.  Also  known  as  Coordinated  Universal  Time,  which  is  an 
international  standard  of  time.  UTC  is  8  hours  behind  Pacific  Standard  Time  and  5  hours 
behind  Eastern  Standard  Time.  See  also  GMT. 

Wide  area  network. 

Wide  area  network  timeout  value. 

A  software  daemon  that  monitors  Fabric  OS  modules  on  the  kernel. 
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WBEM 
WDM 


[need  definition;  BOFMS] 

Wavelength  division  multiplexer.  Allows  multiple  wavelengths  to  be  combined  or  filtered  on  a 
single  cable. 


well-known  address  As  it  pertains  to  Fibre  Channel  technology,  a  logical  address  defined  by  Fibre  Channel 
standards  as  assigned  to  a  specific  function  and  stored  on  the  switch. 

workstation  A  computer  used  to  access  and  manage  the  fabric.  Also  referred  to  as  a  "management 

station"  or  "host." 

WTV  Write  timeout  value.  Refers  to  an  ELS  field  that  appears  in  portLogDump  command  output. 

WWN  world  wide  name.  An  identifier  that  is  unique  worldwide.  Each  entity  in  a  fabric  has  a 

separate  WWN. 

X.25  A  protocol  that  uses  logical  channels.  X.25  allows  high-quality  communications  between 

computers  and  can  accommodate  noisy  data  communications  through  error-detection  and 
-correction  (retransmission)  algorithms. 

xlate  domain  Translate  domain.  A  router  virtual  domain  that  represents  an  entire  fabric.  Device  connectivity 

can  be  achieved  from  one  fabric  to  another,  over  the  router  and  through  this  virtual  domain, 
without  merging  the  two  fabrics.  Also  known  as  phantom  domains. 

zone  A  set  of  devices  and  hosts  attached  to  the  same  fabric  and  configured  as  being  in  the  same 

zone.  Devices  and  hosts  within  the  same  zone  have  access  to  others  in  the  zone  but  are  not 
visible  to  any  outside  the  zone. 

zone  configuration    A  specified  set  of  zones.  Enabling  a  configuration  enables  all  zones  in  that  configuration.  See 
also  defined  zone  configuration,  enabled  zone  configuration. 
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A  feature  in  fabric  switches  or  hubs  that  allows  segmentation  of  a  node  by  physical  port, 
name,  or  address. 
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